Телефоны физлица из открытых источников (экспресс-метод)

C.0177.TEL.MUL

Позволяет получить номера телефонов физических лиц.

При экспресс-методе поиск проводится по части доступных источников — с наиболее упорядоченным и простым в обработке составом данных.

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

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

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

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

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

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

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

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

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

Параметр Тип Обязательность Описание
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 Обязательный,
если не указан другой идентификатор объекта		 Серия и номер паспорта
email string Обязательный,
если не указан другой идентификатор объекта		 Адрес электронной почты
grz string Обязательный,
если не указан другой идентификатор объекта		 ГРЗ ТС
vin string Обязательный,
если не указан другой идентификатор объекта		 VIN ТС
driver_license string Обязательный,
если не указан другой идентификатор объекта		 Серия и номер водительского удостоверения
chassis string Обязательный,
если не указан другой идентификатор объекта		 Номер шасси ТС
body string Обязательный,
если не указан другой идентификатор объекта		 Номер кузова ТС
pts string Обязательный,
если не указан другой идентификатор объекта		 Номер ПТС
sts string Обязательный,
если не указан другой идентификатор объекта		 Номер СТС
address string Обязательный,
если не указан другой идентификатор объекта		 Адрес

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

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

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

Пример тела запроса по хешу серии и номера паспорта

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "passport_hash": "846a2920f653dd11a058035d9d2bfe145bb430645bbcb6a7d9f99ed1dba1ad11"
  }
}

Пример тела запроса по ГРЗ

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "grz": "А111АА00"
  }
}

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

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

Поле Тип Описание
contacts[].phone_number string Номер телефона
contacts[].phone_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.0177.TEL.MUL_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/phn_contact_phone_number",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "source_phones_contact": {
            "contacts": [
              {
                "phone_number": "79600229555",
                "phone_type": "Мобильный телефон",
                "relevance": "55%",
                "data_bank": "100101",
                "data_bank_subpart": "",
                "actuality": "2018-01-01"
              }
            ]
          }
        }
      }
    }
  ]
}