Рукописное распознавание
Пример использования опции "Улучшенное качество" для рукописных Паспортов РФ и регистраций через API:
Примеры изображений документов
Документы для обработки должны быть закодированы в формат base64
Пример ответа по обработанному документу:
{ "document_id": "s-44529", "documents": [ { "key": "PASSPORT", "type": "PASSPORT", "data": { "LastName": "", "FirstName": "", "MiddleName": "", "Gender": "", "BirthDate": "", "BirthPlace": "", "Series": "", "Number": "", "IssuedBy": "", "IssueDate": "", "IssueId": "", "Address": "", "HasPhoto": "", "HasOwnerSignature": "", "MRZ1": "", "MRZ2": "" }, "metadata": { "confidences": { "BirthDate": 0.8149347305297852, "BirthPlace": 0.21398670971393585, "FirstName": 0.4928287863731384, "Gender": 0.755740225315094, "IssueDate": 0.9399173855781555, "IssuedBy": 0.24618881940841675, "IssueId": 0.9072410464286804, "LastName": 0.24597330391407013, "MiddleName": 0.4213537573814392, "Number": 0.9999756813049316, "Series": 0.9999756813049316 }, "verifications": { "status": 0, "status_text": "ok", "checks": { "verify_passport": [ { "status": 0, "key": "fields_to_check_valid", "title": "Одно или несколько обязательных полей отсутствует, имеет неверный формат, имеет неверную контрольную сумму МЧЗ" }, { "status": "", "key": "fio_series_number_mrz", "title": "МЧЗ не согласуется со значением полей" }, { "status": 0, "key": "series_okato", "title": "Серия паспорта не согласуется с кодом подразделения" }, { "status": 0, "key": "region_valid", "title": "Место выдачи не согласуется с кодом подразделения" }, { "status": 0, "key": "issued_after_14", "title": "Паспорт выдан до 14-ти лет" }, { "status": 0, "key": "issued_after_1997", "title": "Паспорт выдан до 1 октября 1997 года" }, { "status": 0, "key": "expiration_date", "title": "Паспорт просрочен" } ] }, "bad_fields": [ "Series", "MiddleName", "Number", "MRZ2", "FirstName", "LastName", "MRZ1" ] }, "metadata_check": { "status": 0, "checks": { "source_check": 1, "suspicious_app_detection": 0, "suspicious_value": "", "create_date": "", "make": "", "model": "" } }, "external_integrations": { "terrorist_extremist": { "value": false } } }, "broken": null, "broken_reasons": [], "broken_reasons_ru": [] } ] }
Описание ключей
Ключ | Тип | Описание |
---|---|---|
document_id | string | номер документа в формате s-<номер документа> |
documents | list | список данных по каждому документу |
documents[].key | string | ключ заданный при отправке документа для отслеживания |
documents[].type | string | тип документа |
documents[].data | dictionary | обработанные данные по каждому полю, содержит ключи полей и их определенные значения |
IssuedBy | string | кем выдан паспорт |
IssueDate | string | дата выдачи паспорта |
IssueId | string | код подразделения |
Series | string | серия паспорта с первого разворота |
Number | string | номер паспорта с первого разворота |
Gender | string | пол |
LastName | string | фамилия |
FirstName | string | имя |
MiddleName | string | отчество |
BirthDate | string | дата рождения |
BirthPlace | string | место рождения |
HasPhoto | boolean или string | попала ли в кадр фотография владельца |
HasOwnerSignature | boolean или string | попала ли в кадр подпись владельца |
MRZ1 | string | первая строка машиночитаемой записи |
MRZ2 | string | вторая строка машиночитаемой записи |
metadata | dictionary | содержит ключи метаданных |
confidences | dictionary {key: float} |
метаданные с точностью обработки по каждому полю - содержит ключи полей и значения уровня уверенности. Значения от 0.0000 до 0.9999, где чем значение больше, тем уверенность в результате выше. Максимальная уверенность - 0.9999. |
verifications | dictionary {key: boolean, key: integer} |
метаданные совершенных проверок - содержит ключи и их значения проверок, см. Правила проверок |