API REFERENCE

Покупка номера

Покупает один номер для выбранного сервиса и страны. Сервер повторно проверяет цену и списывает средства с общего баланса.

POST/api/v1/orders

Авторизация

Персональный ключ в заголовке Authorization: Bearer. Доступ только к вашему аккаунту.

Подробнее об авторизации

Заголовок операции

Idempotency-Keyобязательный

Строка 16–80 символов: A–Z, a–z, 0–9, _ и -. Сохраните ключ до первого запроса и используйте повторно только с исходным телом.

Безопасные повторы

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

servicestring · bodyобязательный
ID сервиса из каталога /services. Латиница, цифры, _ и -; до 40 символов.
countryinteger · bodyобязательный
ID страны из /prices.0 ≤ country ≤ 10000
maxPricenumber · bodyобязательный
Максимальная разрешённая сумма списания в RUB, не более двух знаков после запятой.0 ≤ maxPrice ≤ 1000000

Content-Type: application/json. Максимальное тело: 8192 байта.

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

ПолеТип
orderobject
order.idinteger
order.phonestring
order.pricenumber
order.serviceNamestring
order.countryNamestring
Соглашения и модели данных

HTTP-ответы

Полный справочник ошибок
POST/orders

Client Libraries

9 языков
curl --request POST \
  --url "$LUFFY_BASE_URL"'/orders' \
  --header "Authorization: Bearer $LUFFY_API_KEY" \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: YOUR_SAVED_REQUEST_ID' \
  --data '{"service":"tg","country":0,"maxPrice":0}' \
  --max-time 150 \
  --include --fail-with-body
cURL · shell
Проверить запрос

Ключ только в памяти страницы. Получить ключ

ID сервиса из каталога /services. Латиница, цифры, _ и -; до 40 символов.

ID страны из /prices.

Максимальная разрешённая сумма списания в RUB, не более двух знаков после запятой.

Одна покупка — один ключ. Для повтора вставьте исходный ключ и те же параметры.

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

Реальная операция · требуется подтверждение

HTTP
{
  "order": {
    "id": 123,
    "phone": "+79001234567",
    "price": 50,
    "serviceName": "Telegram",
    "countryName": "Россия"
  }
}

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