Документація SendSend API

Початок роботи

Отримайте API-логін і пароль у кабінеті SendSend. Для доступу потрібна підтверджена пошта, активний пробний період або підписка та налаштоване підключення. Пароль показується лише один раз.

Запит

curl -X POST 'https://api.sendsend.dev/v1/commands' \
  -u 'YOUR_API_LOGIN:YOUR_API_PASSWORD' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: order-4522-notify' \
  -d '{"channel":"telegram","recipient":"RECIPIENT_ID","message":"Ваше замовлення готове"}'

Поля: `channel` — telegram, viber або whatsapp; `recipient` — адресат у форматі, який підтримує підключення; `message` — текст. Запит передається призначеному адміністратором обробнику.

Авторизація та обмеження

HTTPS і HTTP Basic; API-пароль зберігайте лише на своєму сервері.
У запитах рекомендується унікальний `Idempotency-Key` (8–128 символів), щоб повторення запиту не спричинило дубль.
Діє ліміт IP та індивідуальний ліміт запитів на хвилину.
Максимальний JSON payload за умовчанням — 64 КБ.

Відповіді

`202` — обробник прийняв команду; це не гарантія доставки до одержувача.
`401` — неправильні облікові дані.
`402` — підписка неактивна.
`409` — конфлікт ключа ідемпотентності або ще обробляється попередній запит.
`422` — помилка параметрів.
`429` — перевищено ліміт.
`502` / `503` — обробник або підключення недоступні.

{"ok":true,"request_id":"...","status":"accepted"}

Безпека та конфіденційність