SMSCODEX

API v1

Подключите SMSCodex к своему стеку за один спринт

REST и Webhook API с понятной схемой авторизации, SDK и подробными логами. Поддерживаем до 1 500 запросов в секунду на аккаунт без деградации SLA.

Документация Fast PurchaseSwagger (OpenAPI)Запросить ключ sandbox

Как устроена интеграция

  1. 1. Авторизация. Получите API-ключ в личном кабинете (раздел «Настройки → API»). Передавайте его в заголовке X-API-Key с каждым запросом.
  2. 2. Покупка номера. Отправьте POST /api/v1/marketplace/fast-purchase/api, указав сервис, страну и лимит цены. В ответе — номер, статус и время истечения.
  3. 3. Получение кода. Опрашивайте GET /api/v1/marketplace/orders/{id} или ждите Webhook. Как только SMS придёт — код появится в поле last_code.
  4. 4. Завершение. Подтвердите заказ через POST .../complete или отмените через .../cancel. Неиспользованные номера автоматически возвращаются по TTL.

Интерактивная документация

Полная OpenAPI-спецификация доступна в Swagger UI внутри личного кабинета. Там можно протестировать каждый эндпоинт прямо в браузере.

Swagger (OpenAPI) →

Совместимый протокол (Legacy GET API)

Помимо основного REST API, мы поддерживаем совместимый GET-протокол — 14 действий через единую точку входа. Если ваш софт уже работает с подобным форматом, переезд займёт минуты.

Базовый URL: smscodex.com/api/v1/stubs/handler_api.php, авторизация — параметр api_key. Доступны: getBalance, getNumberV2, getStatus, setStatus, getCountries, getPrices и другие.

Полная спецификация доступна в Swagger → раздел «Legacy GET API».

Скачать коллекцию Postman (Legacy)

Пример запроса (Native API)
curl -X POST https://smscodex.com/api/v1/marketplace/fast-purchase/api \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "service_code": "telegram",
    "country": "RU",
    "price_limit": 1.5,
    "currency": "USD"
  }'
Legacy GET API
# Legacy GET API — один URL, 14 действий
curl "https://smscodex.com/api/v1/stubs/handler_api.php\
?api_key=YOUR_API_KEY&action=getBalance"