API(pl)

Wstęp
Aby zaimplementować interfejs API, potrzebujesz:

  1. Aktywne konto Smart Sender i utworzony projekt.

  2. 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

 

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”.