API для реселлеров
Подключи наш каталог к своей панели: 81 услуг на 10 площадках, оптовые цены от объёма и автоматические возвраты за недоставленное.
Методы
| Метод | Путь | Назначение |
|---|---|---|
| GET | /api/v2/services | каталог с ценами, лимитами и признаком долива |
| POST | /api/v2/order | создание заказа, идемпотентность по ключу |
| GET | /api/v2/status | статус одного заказа или списка через запятую |
| POST | /api/v2/refill | запрос долива по выполненному заказу |
| GET | /api/v2/balance | остаток на счёте реселлера |
Как это устроено
Авторизация по ключу в заголовке. Все суммы — целые числа минимальных единиц строкой, без плавающей точки. Создание заказа идемпотентно: повтор с тем же ключом идемпотентности вернёт тот же заказ, а не создаст второй.
Мы посредник и в отношениях с реселлером тоже: заказ уходит подрядчикам, а маршрутизация, повторы и возвраты остаются на нашей стороне. Если подрядчик встал, заказ уйдёт на резервного автоматически — твоему клиенту это видно не будет.
Полная спецификация и песочница выдаются вместе с ключом. Вопросы до подключения — hi@smm-august.ru.
Вопросы про API
Ключ выдаётся в личном кабинете после первого пополнения баланса. Отдельного согласования не нужно, заявку рассматривать не требуется.
Он богаче в двух местах: растяжка задаётся парой «единица плюс значение», а не одним интервалом, и параметры активности передаются типизированным объектом — список реакций, тексты комментариев, номер варианта в опросе. Плоскими колонками это не описать.
Целым числом минимальных единиц, строкой: «34900» — это 349 рублей. Ни одного числа с плавающей точкой ни на одном этапе, включая расчёт наценки.
Заказ закрывается статусом partial, а разница возвращается на баланс реселлера автоматически. Отдельный запрос на возврат для этого не нужен.
Да, лимит на ключ. При его превышении приходит 429 — такие запросы имеет смысл повторить с задержкой, остальные ошибки повторять не нужно.
Не реселлер, а обычный заказ? Собери его на главной.