API Chatwoot: Application, Client i Platform
Trzy rodziny API, różne poświadczenia i zakresy dostępu. Wybierz właściwy interfejs.
W tym artykule
- Dla kogo
- Programista
- Zakres
- Wprowadzenie do trzech rodzin API; nie jest pełną referencją endpointów
Wybierz rodzinę API
Na małym ekranie przewiń tabelę w poziomie.
| Rodzina | Zastosowanie | Uwierzytelnianie i granice |
|---|---|---|
| Application | Operacje na koncie z perspektywy agenta lub administratora | Token użytkownika; dostęp wynika z jego uprawnień |
| Client | Własny interfejs rozmów klienta | Identyfikator skrzynki API i identyfikator kontaktu |
| Platform | Zarządzanie instalacją | Odrębny klucz Platform; ograniczony dostęp do przypisanych obiektów |
Platform API nie uzyskuje automatycznie dostępu do wszystkich kont i użytkowników utworzonych w panelu lub przez inny klucz. Sprawdź jawne przypisania uprawnień. Cloud i self-hosted mają różne możliwości administracji instalacją.
Pierwsze żądanie Application API
Utwórz token w ustawieniach profilu na własnym serwerze. Przechowuj go wyłącznie po stronie zaufanego backendu. Poniższy przykład odczytuje skrzynki konta; wartości zmiennych pochodzą z bezpiecznej konfiguracji Twojej aplikacji.
curl --fail-with-body --header "api_access_token: ${CHATWOOT_ACCESS_TOKEN}" "${CHATWOOT_BASE_URL}/api/v1/accounts/${CHATWOOT_ACCOUNT_ID}/inboxes"
Nie wklejaj tokenu do kodu przeglądarki ani publicznego zgłoszenia. Sprawdź prawo użytkownika do wskazanego konta i zachowanie przy błędnym identyfikatorze.
Obsługa odpowiedzi
Przed wdrożeniem otwórz specyfikację wybranego endpointu dla używanego wydania. Sprawdź wymagane pola, typy, wartości enum, paginację i kody błędów. Zachowaj techniczne nazwy pól bez tłumaczenia.
Klient powinien odróżniać błąd uwierzytelniania, brak uprawnień, brak zasobu i limit wywołań. Nie ponawiaj automatycznie zapisów bez ochrony przed duplikacją.
Ten rozdział jest wprowadzeniem. Pełne parametry poszczególnych operacji i schematy żądań znajdziesz w podlinkowanej dokumentacji producenta.
Źródła i dalsza lektura
Sprawdzono 26.10.2026. Własne opracowanie po polsku na podstawie dokumentacji i komunikatów producenta.