Коробочная версия Стандартизации

Стандартизация DaData.ru подключаются как сервис — регистрируетесь на сайте и используете через интернет (в «облаке»). «Коробку» стандартизации вы скачиваете с сервера «Дадаты» и устанавливаете на свой сервер, дальше она работает в локальной сети.

Сервисы

В «коробку» могут входить API:

Конкретный набор API настраивается в зависимости от ваших потребностей.

API

По смыслу, API «облака» и «коробки» совпадают, но технически они немного отличаются.

Пример URL в облаке:

https://cleaner.dadata.ru/api/v1/clean/address

Пример URL в коробке:

/api/services/rs/EssenceCleanService/cleanEssence

Пример запроса в облаке:

[ "москва сухонская 11 89" ]

Пример запроса в коробке:

{
  "cleanEssenceRequest": {
    "type": "ADDRESS",
    "data": [
      "москва сухонская 11 89"
    ]
  }
}

Пример ответа в облаке:

{
  "source": "москва сухонская 11 89",
  "result": "г Москва, ул Сухонская, д 11, кв 89",
  ...
  "fias_id": "f26b876b-6857-4951-b060-ec6559f04a9a",
  "geo_lat": "55.8783089",
  "geo_lon": "37.6537862",
  "qc_geo": 0,
  "qc": 0
}

Пример ответа в коробке:

{
  "cleanEssenceResponse": {
    "type": "ADDRESS",
    "data": [
      {
        "source": "москва сухонская 11 89",
        "result": "г Москва, ул Сухонская, д 11, кв 89",
        ...
        "fias_id": "f26b876b-6857-4951-b060-ec6559f04a9a",
        "geo_lat": "55.8783089",
        "geo_lon": "37.6537862",
        "qc_geo": "0",
        "qc": "0"
      }
    ]
  }
}

Отличия в типах полей ответа:

Компонент / полеОблакоКоробка
Адрес
metro.distance
qc_geo
qc_complete
qc_house
qc

number
number
number
number
number

string
string
string
string
string
Телефон
phone
qc_conflict
qc


number
number

поле называется result
string
string
Паспорт
qc

number

string
ФИО
gender
qc

М | Ж | НД
number

MALE | FEMALE | UNKNOWN
string
Email
email
qc


number

поле называется result
string
Дата рождения
birthdate
qc


number

поле называется result
string
Автомобиль
qc

number

string

Справочники

В «облаке» справочники обновляем по мере выхода новых версий ФИАС и других источников. В «коробке» вы самостоятельно скачиваете и обновляете все справочники. Чтобы не делать это вручную, мы предоставляем утилиту автоматического обновления («апдейтер»).

Обновления

«Облако» мы обновляем сами. «Коробку» вы обновляете самостоятельно, по нашей инструкции. О выходе новых версий сообщаем по электронной почте один раз в квартал или чаще.

Авторизация и статистика

«Облако» авторизует пользователей по API-ключу, потому что с «Дадатой» работают тысячи компаний, и нам нужно как-то их различать. «Коробкой» пользуется конкретная компания, поэтому авторизации в ней нет.

В «облаке» есть личный кабинет, где показывается статистика запросов по дням. У «коробки» нет личного кабинета, а статистика доступна через метрики Prometheus.

Стоимость

Лицензия разрешает использовать один экземпляр «коробки». Чтобы запустить «коробку» на нескольких серверах (железных, виртуальных или контейнерах), потребуется несколько лицензий: по одной лицензии на каждый экземпляр «коробки». Стоимость лицензии зависит от состава API.

Чтобы купить «коробку», пишите на info@dadata.ru

Сервис поддержки клиентов работает на платформе UserEcho