Wstęp
Aby zaimplementować interfejs API, potrzebujesz:
Aktywne konto Smart Sender i utworzony projekt.
Token uwierzytelniania konta (API token / Access token) – unikalny identyfikator konta służący do weryfikacji Twojego konta we wszystkich żądaniach API.
Ważna uwaga dla programistów: API Smart Sender ma limit 180 żądań na minutę.
Po przekroczeniu tego limitu po raz pierwszy pojawia się 60-sekundowa blokada. Każde przekroczenie limitu linii zwiększa blokadę o 60 sekund (drugie przekroczenie - blokada 120 sekund, trzecie - 180, itd.), ale nie więcej niż 720 sekund blokowania.
Możesz kontrolować liczbę dozwolonych żądań za pomocą nagłówka X-Rate-Limit.
Token uwierzytelniający
Token uwierzytelniania (znany również jako klucz aplikacji) to unikalny i tajny identyfikator konta. Służy do uwierzytelnienia żądania w Smart Sender API i uniemożliwienia stronom trzecim wysyłania żądań w imieniu projektu. Każde żądanie API musi zawierać nagłówek HTTP o nazwie Authorization zawierający token uwierzytelniający konta.
HTTP header
| Code Block |
|---|
Authorization: Bearer O1CpCRhOVuXpMVf5e0An9DMwrn8w7b8CwskbhIBUjgOJ3B2vYzbFZum3oBOF |
Token uwierzytelniania jest generowany podczas tworzenia projektu i może być przeglądany lub modyfikowany przez administratorów projektu na karcie Integracje wybranego projektu.
Uwaga. Jeśli nie wyślesz tokena autoryzacji w nagłówku, spowoduje to błąd z komunikatem „Unauthenticated”.