Страны

Получите список доступных стран для приема SMS.

Получить список стран

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

Endpoint

GET /api/v1/numbers/countries/

Запрос

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/numbers/countries/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ'

Ответ

[
  {
    "code": "666",
    "name": "USA"
  },
  {
    "code": "187",
    "name": "USA (virtual)"
  },
  {
    "code": "51",
    "name": "Belarus"
  },
  {
    "code": "33",
    "name": "Colombia"
  }
]

Поля ответа

Поле	Тип	Описание
code	string	Код страны для использования в других endpoints
name	string	Название страны

Важные примечания

• USA Резидентные: Резидентные номера США используют код 666
• USA Виртуальные: Виртуальные номера США используют код 187
• Коды стран должны передаваться в endpoint /search/ в параметре country
• Разные коды стран могут иметь разные цены и доступность

Типы стран

Резидентные номера

Реальные мобильные телефонные номера с более высоким уровнем доверия. Обычно код 666 для США.

Виртуальные номера

Виртуальные телефонные номера, которые могут получать SMS. Могут иметь разные коды для одной страны (например, код 187 для виртуальных США).

Пример использования

import requests

headers = {
    'accept': 'application/json',
    'X-Api-Key': 'ваш_api_ключ'
}

response = requests.get(
    'https://app.cyberyozh.com/api/v1/numbers/countries/',
    headers=headers
)

countries = response.json()

# Найти USA резидентные
usa_residential = next(c for c in countries if c['code'] == '666')
print(f"USA Резидентные: {usa_residential['name']} (код: {usa_residential['code']})")