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-body

cURL · shell

Проверить запрос

LUFFY_BASE_URL — https://luffysms.com/api/v1. Код запускается на вашем сервере. Кнопка отправляет запрос на текущий сайт.

Реальный запрос · без списания средств

HTTP

JSON Schema

{
  "order": {
    "id": 123,
    "serviceName": "Telegram",
    "serviceId": "tg",
    "countryName": "Россия",
    "phone": "+79001234567",
    "status": "waiting",
    "code": null,
    "price": 50,
    "createdAt": 1780000000000,
    "cancelAfter": 1780000120000
  }
}

Успешный запрос · Пример, не реальные данные

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-body

cURL · shell

Проверить запрос

LUFFY_BASE_URL — https://luffysms.com/api/v1. Код запускается на вашем сервере. Кнопка отправляет запрос на текущий сайт.

Реальный запрос · без списания средств

HTTP

JSON Schema

{
  "order": {
    "id": 123,
    "serviceName": "Telegram",
    "serviceId": "tg",
    "countryName": "Россия",
    "phone": "+79001234567",
    "status": "waiting",
    "code": null,
    "price": 50,
    "createdAt": 1780000000000,
    "cancelAfter": 1780000120000
  }
}

Успешный запрос · Пример, не реальные данные

Авторизация

Параметры запроса

Поля успешного ответа

HTTP-ответы

200Успешный запрос

400Некорректные параметры

401Неверный API-ключ

403Доступ запрещён

404Не найдено

405Метод не поддерживается

409Конфликт операции

413Тело запроса слишком большое

415Неверный формат тела

429Лимит запросов

502Некорректный ответ сервиса

503Сервис недоступен

Client Libraries

LOADING

Авторизация

Параметры запроса

Поля успешного ответа

HTTP-ответы

200Успешный запрос

400Некорректные параметры

401Неверный API-ключ

403Доступ запрещён

404Не найдено

405Метод не поддерживается

409Конфликт операции

413Тело запроса слишком большое

415Неверный формат тела

429Лимит запросов

502Некорректный ответ сервиса

503Сервис недоступен

Client Libraries