API - ua

Введення

Для реалізації API вам знадобиться наступне:

1. Активний акаунт Smart Sender та створений проект.

2. Токен автентифікації облікового запису (API token / Access token) – унікальний ідентифікатор облікового запису, який використовується для перевірки вашого облікового запису в усіх запитах API.

Важливе зауваження для розробників: Smart Sender API має обмеження 180 запитів на хвилину.

У разі перевищення цього обмеження вперше відбувається блокування на 60 секунд. При кожному наступному перевищенні ліміту блокування зростає на 60 секунд (друге перевищення – блокування 120 секунд, третє – 180 і т.д.), але не більше, ніж 720 секунд блокування.
Ви можете контролювати кількість запитів за допомогою заголовка X-Rate-Limit.

Токен аутентифікації

Токен аутентифікації (також відомий як ключ програми) є унікальним та секретним ідентифікатором облікового запису. Він використовується для аутентифікації запиту в API Smart Sender та запобігання надсилання сторонніми особами запитів від імені проекту. Кожний запит API повинен містити заголовок HTTP з ім'ям Authorization, що містить токен аутентифікації облікового запису.

HTTP header

Токен автентифікації генерується під час створення проекту і може бути переглянутий або змінений адміністраторами проекту на вкладці «Інтеграція» вибраного проекту.

Примітка. Якщо ви не надішлете токен автентифікації в заголовку, це призведе до помилки з повідомленням “Unauthenticated“.