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

Да, это основной сценарий: поле «Страна» превращается в выбор из списка, а в базу сохраняется код 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 со всеми полями. Для перехода с 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. Регионы, города и улицы — это адресные продукты.

тарификация

Подсказки

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

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

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

сценарии

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

// intl

Международные формы

Выбор страны с кодами.

// trade

Внешнеэкономическая деятельность

Коды страны в договорах, таможенных и платёжных документах.

// data

Справочники

Единый справочник стран.

вопросы

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

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

по теме