Адрес физлица из открытых источников

C.0084.ADR.MUL

Содержит информацию о предполагаемом адресе физлица.

В ответе может быть выдано несколько адресов, если информация найдена в нескольких банках данных.

Тарифицируется физлицо, по которому найдены адреса (вне зависимости от количества найденных адресов).

Блок отдаёт коды российских справочников адресов — ФИАС (Федеральная информационная адресная система) и КЛАДР (Классификатор адресов Российской Федерации) — для возможности нормализовать адреса при массовой обработке во внутрениих системах. Код КЛАДР доступен для адреса только до уровня дома.

Источники данных — открытые данные в сети Интернет.

Идентификаторы объекта: ФИО и дата рождения или серия и номер паспорта или номер телефона или адрес электронной почты или серия и номер ВУ или идентификатор ТС физлица: ГРЗ, VIN, номер кузова, номер шасси, номер ПТС или номер СТС.

ФИО и дата рождения, серия и номер паспорта, номер телефона могут передаваться в открытом или хешированном виде. Для хеширования данных используется алгоритм SHA-256. Правила хеширования идентификаторов

Иcпользуемые источники: check_person/phn_contact_address.

Время генерации отчёта:

  • 50-й перцентиль — 0,5 с;
  • 95-й перцентиль — 1,5 с.

Параметры запроса

При отправке запроса на генерацию отчёта в теле запроса указываются следующие параметры:

Параметр Тип Обязательность Описание
queryType string Обязательный Тип запроса.
Фиксированное значение: MULTIPART
query string Обязательный Значение простого запроса.
Фиксированное значение:  
data object Обязательный Идентификаторы объекта поиска
Параметры объекта data
fio_birth_hash string Обязательный,
если не указан другой идентификатор объекта
Хеш SHA-256 ФИО и даты рождения
passport_hash string Обязательный,
если не указан другой идентификатор объекта
Хеш SHA-256 серии и номера паспорта
last_name string Обязательный,
если не указан другой идентификатор объекта
Фамилия
first_name string Обязательный,
если не указан другой идентификатор объекта
Имя
patronymic string Обязательный,
если не указан другой идентификатор объекта
Отчество
birth string Обязательный,
если не указан другой идентификатор объекта
Дата рождения
passport string Обязательный,
если не указан другой идентификатор объекта
Серия и номер паспорта
phone_hash string Обязательный,
если не указан другой идентификатор объекта
Хеш SHA-256 номера телефона
phone string Обязательный,
если не указан другой идентификатор объекта
Номер телефона
email string Обязательный,
если не указан другой идентификатор объекта
Адрес электронной почты
grz string Обязательный,
если не указан другой идентификатор объекта
ГРЗ ТС
vin string Обязательный,
если не указан другой идентификатор объекта
VIN ТС
driver_license string Обязательный,
если не указан другой идентификатор объекта
Серия и номер водительского удостоверения
chassis string Обязательный,
если не указан другой идентификатор объекта
Номер шасси ТС
body string Обязательный,
если не указан другой идентификатор объекта
Номер кузова ТС
pts string Обязательный,
если не указан другой идентификатор объекта
Номер ПТС
sts string Обязательный,
если не указан другой идентификатор объекта
Номер СТС

В запросе достаточно передавать только один из наборов данных:

  • fio_birth_hash,
  • passport_hash,
  • last_name, first_name, patronymic, birth,
  • last_name, first_name, birth,
  • passport,
  • phone_hash,
  • phone,
  • email,
  • grz,
  • vin,
  • driver_license,
  • chassis,
  • body,
  • pts,
  • sts,
  • last_name, first_name, patronymic,
  • last_name, first_name.

Если запрос содержит несколько наборов, то для поиска будет использоваться один из них, выбираемый в указанном порядке.

При получении информации из банка данных 100801 не учитывается приоритизация запроса и запрос может осуществляться сразу по нескольким входным ключам вместе:

  • last_name, first_name, patronymic, birth,
  • last_name, first_name, birth,
  • passport
  • phone.

Пример тела запроса по  ФИО и дате рождения

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "last_name": "Иванов",
    "first_name": "Иван",
    "patronymic": "Иванович",
    "birth": "11.02.1991"
  }
}

Пример тела запроса по VIN

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "vin": "EXAMPL0V1N1000000"
  }
}

Структура отчёта

Данные отчёта находятся в объекте data[].content.check_person.source_phones_contact тела ответа.

Поле Тип Описание
contacts[].address string Адрес
contacts[].address_splitted.region string Регион
contacts[].address_splitted.city string Город
contacts[].address_splitted.settlement string Населённый пункт
contacts[].address_splitted.district string Район
contacts[].address_splitted.street string Улица
contacts[].address_splitted.house string Дом
contacts[].address_splitted.structure string Строение
contacts[].address_splitted.corpus string Корпус
contacts[].address_splitted.porch_count string Количество подъездов
contacts[].address_splitted.floor string Этаж
contacts[].address_splitted.floor_count string Количество этажей
contacts[].address_splitted.latitude string Широта
contacts[].address_splitted.longitude string Долгота
contacts[].address_splitted.flat_count string Количество квартир
contacts[].address_splitted.flat_number string Номер квартиры
contacts[].address_splitted.room_number string Номер комнаты
contacts[].address_splitted.index string Почтовый индекс
contacts[].address_splitted.region_code string Код региона
contacts[].address_splitted.fias_code string Код ФИАС
contacts[].address_splitted.kladr_code string Код КЛАДР
contacts[].address_type string Тип адреса
contacts[].relevance string Релевантность ответа
contacts[].data_bank string Банк данных
contacts[].data_bank_subpart string ID подбанка
contacts[].actuality string Дата актуальности в формате YYYY-MM-DD

Пример данных отчёта

{
  "data": [
    {
      "report_type_uid": "C.0084.ADR.MUL_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/phn_contact_address",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "source_phones_contact": {
            "contacts": [
              {
                "address": "Область Самарская область Город Самара Улица Льва Толстого Дом 113 Квартира 36",
                "address_splitted": {
                  "region": "Самарская область",
                  "city": "Самара",
                  "settlement": "",
                  "district": "",
                  "street": "Льва Толстого",
                  "house": "113",
                  "structure": "",
                  "corpus": "",
                  "porch_count": "4",
                  "floor": "",
                  "floor_count": "9",
                  "latitude": "",
                  "longitude": "",
                  "flat_count": "150",
                  "flat_number": "36",
                  "room_number": "",
                  "index": "443041",
                  "region_code": "63",
                  "fias_code": "fd2d3c3d-e9d9-4f9d-acfc-eeae8103176c",
                  "kladr_code": "63000001000028100184"
                },
                "address_type": "Фактический адрес проживания",
                "relevance": "55%",
                "data_bank": "100101",
                "data_bank_subpart": "",
                "actuality": "2018-01-01"
              }
            ]
          }
        }
      }
    }
  ]
}