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

Начало работы

Получите API-логин и пароль в личном кабинете. Нужны подтвержденная почта, пробный или платный доступ и настроенное подключение. Пароль отображается один раз.

Пример запроса

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":"Ваш заказ готов"}'

Поля JSON: `channel` — telegram, viber или whatsapp; `recipient` — адресат в поддерживаемом формате; `message` — текст.

Авторизация и лимиты

• HTTPS и HTTP Basic. Ключ хранится только на вашем сервере.
• Заголовок `Idempotency-Key` (8–128 символов) предотвращает дубли при повторах.
• Действуют лимиты на IP и учетную запись.
• Стандартный максимум тела запроса — 64 КБ.

Ответы

• `202` — команда принята обработчиком, но это не гарантия доставки.
• `401` — неверные ключи.
• `402` — нужна подписка.
• `409` — повторный ключ или запрос в обработке.
• `422` — неверный JSON.
• `429` — превышен лимит.
• `502` / `503` — подключение недоступно.

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

Внутренние адреса серверов скрыты. Журнал API не хранит текст сообщений и адресатов. Отправляйте только тем, кто дал согласие.