API документация

Интегрируйте приём SMS в свои приложения через простой REST API. Все ответы возвращаются в формате JSON.

Аутентификация

Все запросы требуют API-ключ, передаваемый в заголовке Authorization. Без действующего ключа API не работает — любой запрос вернёт ошибку 401 Unauthorized.

Как получить API-ключ

API-ключи не выдаются автоматически. Чтобы получить ключ, обратитесь в поддержку SMSFOX — мы создадим персональный ключ и привяжем его к вашему аккаунту. Никому не передавайте ключ: он даёт полный доступ к API от вашего имени.

bash

Authorization: Bearer YOUR_API_KEY

Базовый URL: https://smsfox.net/api/v1

Ответ без API-ключа

json

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key. Request a key from SMSFOX support."
  }
}

GET/countries

Список стран

Возвращает список доступных стран с кодами и количеством активных номеров.

Запрос

bash

curl https://smsfox.net/api/v1/countries \
  -H "Authorization: Bearer YOUR_API_KEY"

Ответ

json

{
  "data": [
    {
      "slug": "turkey",
      "name": "Турция",
      "code": "tr",
      "dial": "90",
      "active_numbers": 9
    },
    {
      "slug": "usa",
      "name": "США",
      "code": "us",
      "dial": "1",
      "active_numbers": 11
    }
  ]
}

GET/services

Список сервисов

Возвращает список поддерживаемых сервисов с категориями.

Запрос

bash

curl https://smsfox.net/api/v1/services \
  -H "Authorization: Bearer YOUR_API_KEY"

Ответ

json

{
  "data": [
    { "slug": "telegram", "name": "Telegram", "category": "messengers" },
    { "slug": "whatsapp", "name": "WhatsApp", "category": "messengers" },
    { "slug": "google", "name": "Google", "category": "tech" }
  ]
}

GET/numbers?country=turkey

Список номеров

Возвращает доступные номера для указанной страны.

Запрос

bash

curl "https://smsfox.net/api/v1/numbers?country=turkey" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ответ

json

{
  "data": [
    {
      "number": "+90 (532) 123 45 67",
      "full": "905321234567",
      "country": "turkey",
      "status": "active",
      "messages_count": 6
    }
  ]
}

GET/numbers/{full}/messages

Получение сообщений

Возвращает входящие SMS для конкретного номера.

Запрос

bash

curl "https://smsfox.net/api/v1/numbers/905321234567/messages" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ответ

json

{
  "data": [
    {
      "service": "telegram",
      "sender": "Telegram",
      "text": "Telegram code: 54321",
      "code": "54321",
      "received_at": "2026-05-12T10:24:00Z"
    }
  ]
}