f

REST API

Jak dostać klucz API w Nozbe

Naciśnij ikonkę zębatki -> Ustawienia -> Tokeny API i kliknij na “Dodaj nowy klucz dostępu” by wygenerować swój token API.

Tokeny API

Możesz tam dodać nowy token i go nazwać, np. “API Nozbe”. Możesz wygenerować więcej kluczy dostępu i użyć każdego do innej integracji/aplikacji.

Dodawanie tokenu API

Klucze API, które dodajesz, domyślnie dają dostęp tylko do tej przestrzeni, w której zostały dodane. Jeśli chcesz dodać token dający dostęp do Twoich wszystkich przestrzeni, aktywuj opcję “Dodaj jako token ogólny”.

UWAGA: nie udostępniaj nikomu swojego klucza API! Zachowaj klucz API w sekrecie. Udostępnienie go komuś byłoby jak przekazanie mu swojego adresu email oraz hasła. Jeśli wyślesz komuś swój klucz API lub udostępnisz go w Internecie, ryzykujesz wyciekiem swoich danych.

Użyj apikey <API_token> jako nagłówka uwierzytelnienia gdy wchodzisz w Nozbe Rest API.

Jak używać interaktywnej dokumentacji API

  1. Otwórz interaktywną dokumentację Nozbe API dostępną na https://api4.nozbe.com/v1/api
  2. Wybierz “Authorize” i podaj apikey <API_token>
  1. Zacznij używać interaktywnej dokumentacji API poprzez wybranie opcji w danej sekcji i wykonanie żądań poprzez Execute.

Jak wygenerować klientów API za pomocą generatora OpenAPI

Nozbe udostępnia dokument OpenAPI 3.0 na:

https://api4.nozbe.com/v1/api/openapi.yaml

Integracja z API Nozbe może być uproszczona poprzez wygenerowanie kodu klienta za pomocą Generatora OpenAPI (https://openapi-generator.tech/).

Lista dostępnych generatorów klienta jest dostępna tutaj:

https://openapi-generator.tech/docs/generators#client-generators

Przykładowe integracja Ruby z API Nozbe:

  1. Zainstaluj Generator OpenAPI https://openapi-generator.tech/docs/installation/
  2. Wygeneruj kod klienta z (“ruby” można zastąpić innym dostępnym generatorem):
openapi-generator-cli generate -i https://api4.nozbe.com/v1/api/openapi.yaml -g ruby -o /tmp/test/
  1. Jeśli plik README.md został wygenerowany, postępuj według instrukcji w pliku by skompilować i ustawić klienta. Upewnij się, że używasz apikey <API_token> jako nagłówka uwierzytelnienia. Wygenerowane kody klienta API mogą być teraz używane do komunikacji z serwerem Nozbe. Poniżej można zobaczyć przykład użycia wygenerowanych funkcji klienta Ruby by otrzymać projekt Pojedyncze i dodać zadanie z komentarzem: