Возрастная группа

P.0099.AGE.ACT

Содержит информацию о возрастной группе физлица из открытых источников. Эта информация полезна для проведения маркетинговых исследований, разработки программ лояльности и пр.

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

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

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

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

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

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

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

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

Параметр Тип Обязательность Описание
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 Обязательный,
если не указан другой идентификатор объекта
Серия и номер паспорта
inn string Обязательный,
если не указан другой идентификатор объекта
ИНН физического лица
phone_hash string Обязательный,
если не указан другой идентификатор объекта
Хеш SHA-256 номера телефона
phone 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,
  • inn,
  • phone_hash,
  • phone,
  • grz,
  • vin,
  • driver_license,
  • chassis,
  • body,
  • pts,
  • sts,
  • address.

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

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

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

Для получения информации из банка данных 200101 не учитывается приоритизация запроса, так как необходимыми минимальными полями запроса являются одновременно ФИО + ДР + Паспорт, но в случае наличия на вход только одного из этих ключей запроса на стороне источника происходит дообогащение недостающими данными для запроса (если таковые имеются).

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

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "fio_birth_hash": "0b10aa099f31839f73974f37b7565613cf705e71214cf2cdc88e8b1814b20251",
  }
}

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

{
  "queryType": "MULTIPART",
  "query": " ",
  "data": {
    "address": "г. Екатеринбург, ул. Добролюбова, д. 16"
  }
}

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

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

Поле Тип Описание
contacts[].age_group string Возрастная группа
contacts[].relevance string Релевантность ответа
contacts[].data_bank string Банк данных
contacts[].data_bank_subpart string ID подбанка
contacts[].actuality string Дата актуальности

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

{
  "data": [
    {
      "report_type_uid": "P.0099.AGE.ACT_test_report@test_domain",
      "progress_ok": 1,
      "progress_wait": 0,
      "progress_error": 0,
      "state": {
        "sources": [
          {
            "_id": "check_person/phn_contact_agegroup",
            "state": "OK",
            "data": {}
          }
        ],
        "data": {}
      },
      "content": {
        "check_person": {
          "source_phones_contact": {
            "searchKeys": [],
            "contacts": [
              {
                "age_group": "45-50",
                "relevance": "55%",
                "data_bank": "100101",
                "data_bank_subpart": "",
                "actuality": "2018-01-01"
              }
            ]
          },
          "phn_contact_agegroup": {
            "src_meta": {
              "state": "OK",
              "detailed": ""
            }
          }
        }
      }
    }
  ]
}