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 байта.

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

Поле	Тип
order	object
order.id	integer
order.phone	string
order.price	number
order.serviceName	string
order.countryName	string

Соглашения и модели данных

HTTP-ответы

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

Особенности метода

Idempotency-Key обязателен: 16–80 символов, например UUID. Сохраните его и тело запроса ДО отправки.
При таймауте, 5xx или pending: true не создавайте новую покупку. Проверьте историю и повторяйте только исходный запрос с тем же ключом.
Ключ операции общий для аккаунта, сохраняется при перевыпуске API-ключа. Другие параметры с прежним ключом вернут 409.

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

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

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

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

HTTP

JSON Schema

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

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

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

servicestring · bodyобязательный

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

countryinteger · bodyобязательный

ID страны из /prices.0 ≤ country ≤ 10000

maxPricenumber · bodyобязательный

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

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

Поле

Тип

order

object

order.id

integer

order.phone

string

order.price

number

order.serviceName

string

order.countryName

string

HTTP-ответы

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

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

Авторизация

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

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

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

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