API: кем выдан паспорт
Самое утомительное поле при вводе паспорта — «Кем выдан». Писать какое-нибудь «Отделом внутренних дел Медведевского района республики Марий Эл» муторно. Поэтому мы сделали подсказки по полю «Паспорт выдан...».
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
Полнотекстовый поиск (suggest
)
Пример запроса:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "772-053" }' \ https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/fms_unit
var url = "https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/fms_unit"; var token = "${API_KEY}"; var query = "772-053"; var options = { method: "POST", mode: "cors", headers: { "Content-Type": "application/json", "Accept": "application/json", "Authorization": "Token " + token }, body: JSON.stringify({query: query}) } fetch(url, options) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log("error", error));
// https://github.com/hflabs/dadata-php $token = "${API_KEY}"; $dadata = new \Dadata\DadataClient($token, null); $result = $dadata->suggest("fms_unit", "772-053");
# https://github.com/hflabs/dadata-py from dadata import Dadata token = "${API_KEY}" dadata = Dadata(token) result = dadata.suggest("fms_unit", "772-053")
Поиск работает по полям:
code
name
Укажите при вызове:
Content-Type: application/json
.Accept: application/json
.${API_KEY}
— API-ключ.
Тело запроса передавайте в кодировке UTF-8
.
Фильтрация
Фильтрация работает по полям region_code
(первые 2 цифры КЛАДР-кода региона) и type
(вид подразделения):
{ "query": "иванов", "filters": [ { "region_code": "37" } ] }
{ "query": "бел", "filters": [ { "region_code": "02", "type": "2" } ] }
Поля справочника
Название | Описание |
---|---|
value | Значение одной строкой (как показывается в списке подсказок) |
unrestricted_value | = value |
data.code | Код подразделения |
data.name | Название подразделения в творительном падеже («кем выдан?») |
data.region_code | Код региона (2 цифры) |
data.type | Вид подразделения (1 цифра)0 — подразделение ФМС 1 — ГУВД или МВД региона 2 — УВД или ОВД района или города 3 — отделение полиции |
Источник данных: открытый справочник «Кем выдан паспорт» (подробности на «Хабре»).
Ограничения
Длина запроса (параметр query
) — не более 300 символов.
Количество запросов в день — в соответствии с тарифным планом.
Максимальная частота запросов — 30 в секунду с одного IP-адреса.
Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.
Стоимость
Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.