Platformowe API monday.com wykorzystuje osobiste tokeny API V2, aby uwierzytelniać żądania i identyfikować użytkownika, który je wysyła. Tokeny są przypisane do konkretnych użytkowników i nie mają określonej długości.

Osobiste tokeny pozwalają korzystać z API na własnym koncie użytkownika. Ich uprawnienia odzwierciedlają to, co możesz zrobić w interfejsie monday.com. Dzięki temu dostęp przez API jest zgodny z Twoimi uprawnieniami na platformie.

Jeśli nie masz jeszcze konta monday.com, utwórz bezpłatne konto deweloperskie, aby uzyskać token API i rozpocząć testowanie.

Uprawnienia tokenu

Osobiste tokeny odzwierciedlają wszystkie poziomy uprawnień ustawione w interfejsie monday.com, w tym dostęp do tablic, kolumn, elementów lub kont.

Na przykład: jeśli nie masz uprawnień do obszaru roboczego w interfejsie, nie uzyskasz do niego dostępu również za pomocą osobistego tokenu API.

Tokeny aplikacji mają dodatkowy zestaw zakresów uprawnień, który określa, do jakich zapytań i mutacji aplikacja ma dostęp. Osobiste tokeny mają wszystkie zakresy uprawnień.

Dostęp do tokenu

Dostęp do tokenu API możesz uzyskać na dwa sposoby, zależnie od typu użytkownika.

W Centrum deweloperskim (wszyscy użytkownicy)

Wszyscy użytkownicy z dostępem do API mogą wykonać te kroki, aby uzyskać dostęp do tokenu API:

1. Na koncie monday.com kliknij zdjęcie profilowe w prawym górnym rogu.
2. Wybierz Deweloperzy (Developers). Otworzy się Centrum deweloperskie (Developer Center) w nowej karcie.
3. Kliknij Token API (API token) > Pokaż (Show).
4. Skopiuj swój osobisty token.

Na karcie Administracja (tylko administratorzy konta)

Administratorzy konta mogą wykonać powyższe kroki w Centrum deweloperskim albo uzyskać dostęp do tokenu na karcie Administracja (Administration):

1. Na koncie monday.com kliknij zdjęcie profilowe w prawym górnym rogu.
2. Wybierz Administracja (Administration) > Połączenia (Connections) > Osobisty token API (Personal API token).
3. Skopiuj swój osobisty token.

Wysyłanie żądań z tokenem

Gdy masz już token, możesz wysyłać żądania do API. Przekaż token w nagłówku Authorization.

curl -X POST https://api.monday.com/v2 \
  -H "Authorization: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"query": "query { me { id name } }"}'

Ponowne generowanie tokenu

Tokeny API możesz wygenerować ponownie w dowolnym momencie. Spowoduje to jednak natychmiastowe unieważnienie obecnego tokenu, dlatego zaktualizuj wszystkie korzystające z niego integracje.

Jak ponownie wygenerować token

W Centrum deweloperskim

1. Na koncie monday.com kliknij zdjęcie profilowe w prawym górnym rogu.
2. Wybierz Deweloperzy. Otworzy się Centrum deweloperskie w nowej karcie.
3. Kliknij Token API > Wygeneruj ponownie (Regenerate).

Na karcie Administracja

1. Na koncie monday.com kliknij zdjęcie profilowe w prawym górnym rogu.
2. Wybierz Administracja > Połączenia > Osobisty token API.
3. Kliknij Wygeneruj ponownie.