API REFERENCE
Статус заказа и SMS
Возвращает состояние вашего заказа и полученный SMS-код. Чужой или несуществующий заказ возвращает 404.
GET
/api/v1/orders/{id}Авторизация
Персональный ключ в заголовке Authorization: Bearer. Доступ только к вашему аккаунту.
Подробнее об авторизацииПараметры запроса
idinteger · pathобязательный- ID вашего заказа из ответа покупки.1 ≤ id ≤ 999999999999999
Поля успешного ответа
| Поле | Тип |
|---|---|
| order | object |
| order.id | integer |
| order.serviceName | string |
| order.serviceId | string |
| order.countryName | string |
| order.phone | string |
| order.status | waiting | completed | cancelled | error |
| order.code | string | null |
| order.price | number |
| order.createdAt | integer |
| order.cancelAfter | integer |
HTTP-ответы
Особенности метода
- Опрос не чаще одного раза в 5 секунд. Бот проверяет SMS в фоне, API читает общую базу.
- Статусы: waiting — ожидание; completed — завершён; cancelled — отменён; error — ошибка. При конечном статусе остановите опрос.
- code — строка или null. Не превращайте код в число, чтобы сохранить начальные нули. createdAt и cancelAfter — Unix-время в миллисекундах.
GET
/orders/{id}Client Libraries
9 языковcurl --request GET \
--url "$LUFFY_BASE_URL"'/orders/ORDER_ID' \
--header "Authorization: Bearer $LUFFY_API_KEY" \
--max-time 150 \
--include --fail-with-bodycURL · shell
Проверить запрос
Ключ только в памяти страницы. Получить ключ
ID вашего заказа из ответа покупки.
LUFFY_BASE_URL — https://luffysms.com/api/v1. Код запускается на вашем сервере. Кнопка отправляет запрос на текущий сайт.
Реальный запрос · без списания средств
HTTP
{
"order": {
"id": 123,
"serviceName": "Telegram",
"serviceId": "tg",
"countryName": "Россия",
"phone": "+79001234567",
"status": "waiting",
"code": null,
"price": 50,
"createdAt": 1780000000000,
"cancelAfter": 1780000120000
}
}Успешный запрос · Пример, не реальные данные