Подойдёт ли для формы регистрации на сайте?

Да, это основной сценарий: поле «Страна» превращается в выбор из списка, а в базу сохраняется код ISO, а не текст.

Можно ли этим же ключом получить валюты?

Да. Валюты — отдельный справочник HintData с кодами ISO 4217 и символами, он работает по тому же ключу.

Сколько стоит?

Подсказки входят в бесплатный дневной лимит: 10 000 запросов в сутки. Нужен объём больше — его открывает платный тариф.

Как быстро подключить?

Ключ выдаётся сразу после регистрации, дальше это готовый виджет или один запрос из вашей формы.

справочник

Справочник
стран

Коды ISO 3166 — буквенные alpha-2/alpha-3 и числовой — и официальное название страны.

Документация →

249

стран и территорий

ISO

3166

~3мс

ответ

POST

↵ enter

200 OKapplication/json, 7ms

{
  "query": "Россия",
  "suggestions": [
    {
      "value": "Россия",
      "code": "643",
      "alfa2": "RU",
      "alfa3": "RUS",
      "name": "Российская Федерация"
    }
  ]
}

Сценарий: Страна в анкете клиента →

что вы получаете

Возможности страны

Коды ISO

alpha-2, alpha-3 и числовой код 3166.

Названия

Краткое и полное официальное название.

Поиск

По названию или коду.

Поля ответа 5

Наши методы отдают структурированный JSON: каждая сущность — отдельным объектом.

/v1/suggest/country/v1/find/country

Переходите с DaData — те же подсказки, поиск по идентификатору работают по привычным адресам в их формате. Менять код не нужно: другими будут только базовый адрес и заголовок авторизации.

/suggestions/api/4_1/rs/suggest/country/suggestions/api/4_1/rs/findById/country

Готовое значениеКодКод ISO из двух буквКод ISO из трёх буквНазвание

Источник: ОКСМ / ISO 3166 .

о сервисе

Что такое справочник стран

Свободный ввод страны быстро превращается в десяток написаний одной строки: «Соединенные Штаты», «Соед. Штаты», «USA». Подсказки закрывают поле списком: человек набирает несколько букв или код, выбирает строку, а в базу попадает запись с кодом ISO 3166-1, буквенным и числовым, и официальным названием для документов. В справочнике 251 страна и территория. Чистить поле руками больше не нужно.

Как подключить справочник стран

Ключ выдаётся сразу после регистрации, дальше подсказка ставится на поле «Страна» — готовым виджетом или своим запросом. Пользователь видит список, система сохраняет код. Тот же справочник приводит старые выгрузки к общему виду: «Соединенные Штаты», «US» и «840» сходятся в одну запись. Формат DaData поддерживается — переписывать разбор ответа не придётся.

Что важно знать про справочник стран

Справочник отвечает за коды и названия стран, и этого достаточно анкетам, банковским и таможенным документам, где нужен код ISO. Телефонных кодов и доменных зон в нём нет, а валюты вынесены в отдельный справочник HintData. Регионы, города и улицы — это адресные продукты.

тарификация

Подсказки

Подсказки входят в дневной лимит тарифа и доступны на всех планах, включая бесплатный.

в подпискепо дневному лимиту

Все тарифы и цены →

сценарии

Где это полезно

пример заполнения и API

Страна в анкете клиента

Страна в анкете клиента: подсказки по названию заполняют коды ISO 3166 alpha-2, alpha-3 и числовой код. Пример формы и код подключения справочника.

Посмотреть пример

пример заполнения и API

Страна назначения международной посылки

Страна назначения посылки: подсказки по названию заполняют коды ISO alpha-2 и alpha-3 для международного отправления. Пример формы и код API.

Посмотреть пример

Все сценарии API

вопросы

Частые вопросы про справочник стран

Подойдёт ли для формы регистрации на сайте?: Да, это основной сценарий: поле «Страна» превращается в выбор из списка, а в базу сохраняется код ISO, а не текст.
Можно ли этим же ключом получить валюты?: Да. Валюты — отдельный справочник HintData с кодами ISO 4217 и символами, он работает по тому же ключу.
Сколько стоит?: Подсказки входят в бесплатный дневной лимит: 10 000 запросов в сутки. Нужен объём больше — его открывает платный тариф.
Как быстро подключить?: Ключ выдаётся сразу после регистрации, дальше это готовый виджет или один запрос из вашей формы.

по теме