API REFERENCE
Покупка номера
Покупает один номер для выбранного сервиса и страны. Сервер повторно проверяет цену и списывает средства с общего баланса.
/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.
/ordersClient 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Проверить запрос
Ключ только в памяти страницы. Получить ключ
ID сервиса из каталога /services. Латиница, цифры, _ и -; до 40 символов.
ID страны из /prices.
Максимальная разрешённая сумма списания в RUB, не более двух знаков после запятой.
Одна покупка — один ключ. Для повтора вставьте исходный ключ и те же параметры.
LUFFY_BASE_URL — https://luffysms.com/api/v1. Код запускается на вашем сервере. Кнопка отправляет запрос на текущий сайт.
Реальная операция · требуется подтверждение
{
"order": {
"id": 123,
"phone": "+79001234567",
"price": 50,
"serviceName": "Telegram",
"countryName": "Россия"
}
}Успешный запрос · Пример, не реальные данные