Czy monday.com ma API?
Jak najbardziej! Nasze API jest oparte na GraphQL i zapewnia dużą elastyczność w dostępie do informacji na Twoim koncie monday.com i ich modyfikowaniu.
Wskazówka:
Więcej szczegółowych informacji na temat API znajdziesz w dokumentacji API.
Uwaga: Jeśli wykorzystasz dzienny limit wywołań API, administrator może dokupić dodatkowy limit za pomocą dodatku do wywołań API. Można to zrobić w sekcji administracyjnej, kontaktując się z zespołem obsługi Twojego konta lub z pomocą techniczną. Każda jednostka zwiększa dzienny limit o 25 000 wywołań API. Możesz kupić kilka jednostek.
Dlaczego GraphQL?
Użytkownicy korzystają z monday.com do zarządzania różnymi rodzajami informacji. Chcieliśmy więc stworzyć API tak elastyczne jak nasza platforma. Dlatego zbudowaliśmy API obsługujące rozbudowane zapytania, które pozwalają pobrać dokładnie te informacje, których potrzebujesz, w odpowiednim momencie. Jeśli chcesz dowiedzieć się więcej o GraphQL jako języku zapytań, odwiedź stronę graphql.org. 😄
Dokumentacja i testowanie
Aby ułatwić korzystanie z naszego API, przygotowaliśmy dokumentację opisującą zapytania i mutacje, których możesz używać do pracy z danymi. Możesz też testować zapytania w naszym eksploratorze GraphQL.
Uwierzytelnianie za pomocą tokenu API
Każde żądanie do naszego API musi zawierać token API, żebyśmy wiedzieli, że to Ty. 😊
API dla administratorów
Każdy administrator konta ma własny token API. Zadbaj o jego bezpieczeństwo! Aby wygenerować token API:
- Zaloguj się na swoje konto monday.com.
- Kliknij swój awatar w prawym górnym rogu.
- Wybierz kartę Administracja (Administration).
- Kliknij Połączenia (Connections) po lewej stronie strony administracyjnej.
- Z menu rozwijanego wybierz Osobisty token API (Personal API token).
- Kliknij przycisk Kopiuj (Copy) po prawej stronie osobistego tokenu API. Powinien wyświetlić się taki widok:
API dla użytkowników niebędących administratorami
Jeśli nie jesteś administratorem swojego konta monday.com, możesz uzyskać tokeny API w sekcji dla deweloperów. Wykonaj te czynności:
- Zaloguj się na swoje konto monday.com.
- Kliknij swój awatar w prawym górnym rogu.
- Wybierz Deweloperzy (Developers).
- U góry kliknij Deweloper (Developer), a następnie Moje tokeny dostępu (My Access Tokens).
- Kliknij Pokaż (Show) obok tokenu API, aby go wyświetlić i skopiować.
Możesz używać tego tokenu API do uwierzytelniania wszystkich żądań do naszego API, a także w naszym środowisku testowym. Token możesz wygenerować ponownie w dowolnym momencie, ale pamiętaj, że wtedy poprzedni token wygaśnie.
Tokeny API generowane przez OAuth
Możesz też wygenerować token dla konkretnych aplikacji, korzystając z procesu autoryzacji OAuth. Uprawnienia tych tokenów są ograniczone do zakresów autoryzacji aplikacji, z którą są powiązane. Więcej informacji znajdziesz w naszej dokumentacji OAuth.
Uprawnienia tokenów API
Token API każdego użytkownika ma uprawnienia przypisane temu użytkownikowi.
Na przykład jeśli użytkownik ma dostęp tylko do odczytu do określonej tablicy, za pomocą jego tokenu API nie będzie można aktualizować informacji na tej tablicy.
Podobnie jeśli użytkownik nie ma dostępu do prywatnej tablicy, aplikacje korzystające z jego tokenu API również nie będą mieć do niej dostępu.
Uwaga: Obecnie nie obsługujemy tokenów API „superuser”, które zapewniają dostęp do odczytu i zapisu do wszystkich tablic na koncie.
Dostęp do naszego API GraphQL
Wiemy, że użytkownicy lubią testować rozwiązania przed ich wdrożeniem, dlatego dodaliśmy edytor zapytań bezpośrednio na naszej platformie. Możesz za jego pomocą wypróbować zapytania i mutacje, zanim wdrożysz je w swojej aplikacji. Aby skorzystać z eksploratora API, przejdź pod ten link.
Po otwarciu strony eksploratora wpisz token API w tym polu:
Po podaniu tokenu przejdziesz do naszego środowiska testowego. Wpisz zapytanie lub mutację w lewym panelu eksploratora. Po kliknięciu Uruchom (Play) w lewym górnym rogu wyniki pojawią się w prawym panelu.
Możesz też kliknąć przycisk Dokumentacja (Docs) w prawym górnym rogu, aby otworzyć dokumentację bezpośrednio z eksploratora. Aby przejść do dokumentacji poza eksploratorem, skorzystaj z tego linku.
Wysyłanie żądań
Przetestowałeś już zapytania i chcesz wysyłać je bezpośrednio ze swojej aplikacji? Jesteś we właściwym miejscu. 😊
Wszystkie żądania do naszego serwera muszą być żądaniami POST wysyłanymi na adres api.monday.com/v2.
Ustaw typ zawartości na application/json i przekaż klucz API jako parametr „Authorization” w nagłówkach:
{
"Content-Type" : "application/json",
"Authorization" : "mySuperSecretAPIKey"
}
W treści żądania przekazuje się zapytanie i zmienne. Powinna wyglądać tak:
{
"query" : "...",
"variables" : {"myVariable" : "foo", "yourVariable" : "bar"}
}
Kolekcja Postman
Zebraliśmy przykłady najczęściej używanych żądań API w kolekcji Postman. Możesz jej używać do testowania przykładowych żądań za pomocą naszego API i generowania fragmentów kodu do skopiowania do swojej aplikacji. Zobacz przykłady, aby przetestować własne żądania.
Dlaczego warto korzystać z API?
Nie wiesz, czy potrzebujesz API? API umożliwia niestandardowym aplikacjom dostęp do monday work OS, dzięki czemu możesz łączyć własne skrypty, integracje i narzędzia ze swoimi procesami. Jeśli Cię to interesuje, API jest dla Ciebie.
Możesz wykorzystać API na wiele sposobów, aby usprawnić swoje procesy. Oto kilka przykładów:
- Łączenie zewnętrznych integracji danych
- Konfigurowanie narzędzi integracyjnych no-code, takich jak Zapier, do tworzenia niestandardowych przepływów danych
- Importowanie i eksportowanie danych w partiach
- Używanie API jako warstwy danych dla niestandardowych aplikacji monday, które łączą się z monday
Jak rozwijać swoje rozwiązania
Platforma monday zawiera też narzędzia do tworzenia aplikacji osadzonych w Twoich procesach, takich jak widoki tablic aplikacji, integracje i inne.
Jeśli potrzebujesz jeszcze więcej możliwości usprawniania swoich procesów, możesz użyć frameworka monday apps do tworzenia niestandardowych aplikacji odpowiadających konkretnym potrzebom w Twoim obszarze roboczym. Więcej informacji znajdziesz w dokumentacji Apps Framework i w naszych przykładach.
Limity liczby żądań
Limity liczby żądań API zależą od poziomu złożoności. Limit wynosi 10,000,000 na minutę na konto. Więcej informacji znajdziesz tutaj!
Powodzenia w programowaniu!
Skoro znasz już podstawy wysyłania żądań do naszego API, zapoznaj się z dokumentacją API. Możesz też wypróbować nasze środowisko testowe!
Na koniec sprawdź nasze samouczki szybkiego startu w różnych językach programowania: