↑ API подсказок

API справочников: страны

Справочник стран мира по стандарту ISO 3166.

Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.

Полнотекстовый поиск (suggest)

Пример запроса:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "та" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/country

Поиск работает по полям:

  • code
  • alfa2
  • alfa3
  • name_short
  • name

Запись справочника по идентификатору (findById)

Пример запроса:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "TH" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/country

Выборка по идентификатору работает по полям:

  • code
  • alfa2
  • alfa3

Поля справочника

Название Описание
value Значение одной строкой (как показывается в списке подсказок)
data.code Цифровой код страны
data.alfa2 Буквенный код альфа-2
data.alfa3 Буквенный код альфа-3
data.name_short Краткое наименование страны
data.name Полное официальное наименование страны

Источник данных: Общероссийский классификатор стран мира (ОКСМ)

Ограничения

Длина запроса (параметр query) — не более 300 символов.

Количество запросов в день — в соответствии с тарифным планом.

Максимальная частота запросов — 20 в секунду.

Максимальная частота создания новых соединений — 60 в минуту.

Стоимость

Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.

ajax-spinner

Зарегистрируйтесь, чтобы подключить API

до 10 тыс. запросов бесплатно

чтобы обращаться к вам в письмах

Регистрируясь, вы принимаете публичную оферту

Уже зарегистрированы? Войти