API стандартизации

curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Token ${API_KEY}" \
    -H "X-Secret: ${SECRET_KEY}" \
    -d '[ "тел 7165219 доб139" ]' \
    https://dadata.ru/api/v2/clean/phone

curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Token ${API_KEY}" \
    -H "X-Secret: ${SECRET_KEY}" \
    -d '[ "4509 235857" ]' \
    https://dadata.ru/api/v2/clean/passport

curl -X POST \
     -H "Content-Type: application/json" \
     -H "Authorization: Token ${API_KEY}" \
     -H "X-Secret: ${SECRET_KEY}" \
     -d '[ "Срегей владимерович иванов" ]' \
     https://dadata.ru/api/v2/clean/name

curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Token ${API_KEY}" \
    -H "X-Secret: ${SECRET_KEY}" \
    -d '[ "serega@yandex/ru" ]' \
    https://dadata.ru/api/v2/clean/email

curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Token ${API_KEY}" \
    -H "X-Secret: ${SECRET_KEY}" \
    -d '[ "24/3/12" ]' \
    https://dadata.ru/api/v2/clean/birthdate

curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Token ${API_KEY}" \
    -H "X-Secret: ${SECRET_KEY}" \
    -d '[ "форд фокус" ]' \
    https://dadata.ru/api/v2/clean/vehicle

cat > ./request.json <<EOF
{
  "structure": [
    "AS_IS",
    "NAME",
    "ADDRESS",
    "PHONE" ],
  "data": [
    [ "1",
      "Федотов Алексей",
      "Москва, Сухонская улица, 11 кв 89",
      "8 916 823 3454"
    ],
    [ ["2"],
      ["Иванов", "Сергей Владимирович"],
      ["мск", "улица свободы", "65", "12"],
      ["495 663-12-53"]
    ],
    [ "3",
      ["Ольга Павловна", "Ященко"],
      ["", "Спб, ул Петрозаводская 8", "", ""],
      "457 07 25"
    ]
  ]
}
EOF

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -H "X-Secret: ${SECRET_KEY}" \
  -d @request.json \
  https://dadata.ru/api/v2/clean

structure — структура записи, содержит четыре поля:

• AS_IS — оставить как есть (не стандартизировать),
• NAME — разобрать как ФИО,
• ADDRESS — разобрать как адрес,
• PHONE — разобрать как телефон.

data — три записи (Федотов, Иванов и Ольга Павловна), каждая из которых содержит четыре поля. Поле — либо одно значение ("Федотов Алексей"), либо массив значений (["мск", "улица свободы", "65", "12"]).

[
    {
    "source": "тел 7165219 доб139", 
    "type": "Стационарный", 
    "phone": "+7 495 716-52-19 доб. 139", 
    "country_code": "7", 
    "city_code": "495", 
    "number": "7165219", 
    "extension": "139", 
    "provider": "ОАО \"МГТС\"", 
    "region": "Москва", 
    "timezone": "UTC+3", 
    "qc_conflict": 0, 
    "qc": 1
}
]

Коды качества

Код проверки (qc) — нужно ли вручную проверить распознанный телефон:

Признак конфликта телефона с адресом (qc_conflict) — указал ли клиент телефон, соответствующий его адресу. Удобно для проверки уровня риска:

[
    {
    "source": "4509 235857", 
    "series": "45 09", 
    "number": "235857", 
    "qc": 0
}
]

Код качества

Код проверки (qc) — действует паспорт или нет, по данным Федеральной миграционной службы:

[
    {
    "source": "Срегей владимерович иванов", 
    "result": "Иванов Сергей Владимирович", 
    "result_genitive": "Иванова Сергея Владимировича", 
    "result_dative": "Иванову Сергею Владимировичу", 
    "result_ablative": "Ивановым Сергеем Владимировичем", 
    "surname": "Иванов", 
    "name": "Сергей", 
    "patronymic": "Владимирович", 
    "gender": "М", 
    "qc": 1
}
]

Код качества

Код проверки (qc) — требуется ли вручную проверить распознанное значение:

[
    {
    "source": "serega@yandex/ru", 
    "email": "serega@yandex.ru", 
    "qc": 4
}
]

Код качества

Код проверки (qc) — подходит ли email для маркетинговой рассылки:

[
    {
    "source": "24/3/12", 
    "birthdate": "24.03.2012", 
    "qc": 1
}
]

Код качества

Код проверки (qc) — требуется ли вручную проверить распознанное значение:

[
    {
    "source": "форд фокус", 
    "result": "FORD FOCUS", 
    "brand": "FORD", 
    "model": "FOCUS", 
    "qc": 0
}
]

Код качества

Код проверки (qc) — требуется ли вручную проверить распознанное значение:

{
    "structure": [
        "AS_IS",
        "NAME",
        "ADDRESS",
        "PHONE"
    ],
    "data": [
        [{
            "source": "1"
        }, {
            "source": "Федотов Алексей",
            "result": "Федотов Алексей",
            ...
            "qc": 0
        }, {
            "source": "Москва, Сухонская улица, 11 кв 89",
            "result": "г Москва, ул Сухонская, д 11, кв 89",
            ...
            "qc": 0,
            "unparsed_parts": null
    }, {
            "source": "8 916 823 3454",
            "type": "Мобильный",
            "phone": "+7 916 823-34-54",
            ...
            "qc": 0
        }],
        [{
            "source": "2"
        }, {
            "source": "Иванов Сергей Владимирович",
            "result": "Иванов Сергей Владимирович",
            ...
            "qc": 0
        }, {
            "source": "мск,улица свободы,65,12",
            "result": "г Москва, ул Свободы, д 65, кв 12",
            ...
            "qc": 0,
            "unparsed_parts": null
        }, {
            "source": "495 663-12-53",
            "type": "Стационарный",
            "phone": "+7 495 663-12-53",
            ...
            "qc": 0
        }],
        [{
            "source": "3"
        }, {
            "source": "Ольга Павловна Ященко",
            "result": "Ященко Ольга Павловна",
            ...
            "qc": 0
        }, {
            "source": "Спб, ул Петрозаводская 8",
            "result": "Россия, г Санкт-Петербург, ул Петрозаводская, д 8",
            ...
            "qc": 0,
            "unparsed_parts": null
        }, {
            "source": "457 07 25",
            "type": "Стационарный",
            "phone": "+7 812 457-07-25",
            ...
            "qc": 1
        }]
    ]
}

Структура записи

Обрабатывайте разные типы данных: