API
Стандартный API v2 для SMM-панелей. Инструменты и панели, поддерживающие этот формат, подключаются с Вашим ключом API.
- Адрес
- https://4xpanel.com/api/v2
- Метод
- POST. Отправляйте поля формы (или JSON) методом POST. Ответы приходят в JSON. Ошибки приходят как {"error": "..."}.
- Ключ API
- Создайте его на странице «Ключ API» после зачисления первого пополнения.
- Лимиты
- 300 запросов в минуту на ключ. Status принимает до 100 ID заказов за раз.
services
Список услуг
| Параметр | Описание |
|---|---|
| key | Ваш ключ API |
| action | services |
Пример ответа
[{"service":1,"name":"Video views","type":"Default","category":"TikTok - Views","rate":"0.0500","min":"100","max":"1000000","refill":true,"cancel":false}]add
Оформить заказ
| Параметр | Описание |
|---|---|
| key | Ваш ключ API |
| action | add |
| service | ID услуги |
| link | Ссылка |
| quantity | Количество (не для пакетов и своих комментариев) |
| comments | Свои комментарии, по одному в строке (услуги своих комментариев) |
Пример ответа
{"order":23501}status
Статус заказа
| Параметр | Описание |
|---|---|
| key | Ваш ключ API |
| action | status |
| order | ID заказа |
Пример ответа
{"charge":"0.2500","start_count":"3572","status":"Partial","remains":"157","currency":"USD"}status (multiple)
Статус до 100 заказов
| Параметр | Описание |
|---|---|
| key | Ваш ключ API |
| action | status |
| orders | ID заказов через запятую |
Пример ответа
{"23501":{"charge":"0.2500","start_count":"3572","status":"Partial","remains":"157","currency":"USD"},"10":{"error":"Incorrect order ID"}}refill
Запросить докрутку
| Параметр | Описание |
|---|---|
| key | Ваш ключ API |
| action | refill |
| order | ID заказа |
Пример ответа
{"refill":"1"}refill_status
Статус докрутки
| Параметр | Описание |
|---|---|
| key | Ваш ключ API |
| action | refill_status |
| refill | ID докрутки |
Пример ответа
{"status":"Completed"}balance
Баланс кошелька
| Параметр | Описание |
|---|---|
| key | Ваш ключ API |
| action | balance |
Пример ответа
{"balance":"100.84","currency":"USD"}Статусы заказа
Pending, In progress, Completed, Partial, Canceled
Статусы докрутки
Pending, In progress, Completed, Rejected
Ошибки
| Ошибки | Описание |
|---|---|
| Invalid API key | Ключ неверный или был заменён, либо ещё не зачислено ни одного пополнения |
| Incorrect service ID | Нет услуги в продаже с таким ID |
| Incorrect link | Ссылка не является полным веб-адресом |
| Quantity out of range | Меньше минимума или больше максимума |
| Not enough funds | В кошельке недостаточно средств для оплаты |
| Too many requests | Больше 300 запросов в минуту |
| Refill not available | У услуги нет докрутки, заказ не завершён, период истёк или докрутку запрашивали менее 24 часов назад |
| Incorrect order ID | У Вас нет заказа с таким ID |
| Incorrect refill ID | У Вас нет докрутки с таким ID |
| Incorrect comments | Пусто, больше 10 000 строк или строка длиннее 500 символов |
| Incorrect request | Неизвестное действие (action) |
| Bad request | Не удалось прочитать тело запроса |