↑ Все API

API: страны

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

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

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

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

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/country
            
            
{ "query": "та" }

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

  • code
  • alfa2
  • alfa3
  • name_short
  • name

Укажите при вызове:

  • Content-Type: application/json.
  • Accept: application/json.
  • ${API_KEY} — API-ключ.

Тело запроса передавайте в кодировке UTF-8.

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

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

            
                POST http://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/country
            
            
{ "query": "TH" }

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

  • code
  • alfa2
  • alfa3

Укажите при вызове:

  • Content-Type: application/json.
  • Accept: application/json.
  • ${API_KEY} — API-ключ.

Тело запроса передавайте в кодировке UTF-8.

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

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

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

Ограничения

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

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

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

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

Стоимость

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