Подписи и печати

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

Чтобы воспользоваться сервисом, отправьте POST-запрос на URL https://latest.dbrain.io/check/sign_seal

Перед началом работы с сервисами изучите раздел «Общая информация о сервисах». Там мы рассказываем про допустимые форматы файлов, виды запросов и ответов, набор HTTP-статусов и даём рекомендации по устранению ошибок

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

Асинхронный запрос

async — boolean

Поведение по умолчанию: async=false — сервис обрабатывает запросы синхронно. При отправке запроса вы получите ответ только после окончательного завершения обработки запроса сервисом.

Если вам нужен асинхронный режим, укажите в запросе async=true. В ответ на запрос сервис вернёт в response body параметр task_id. Например:

"task_id": "96b8ccc950a70699927036842c624d7c"

Используйте этот task_id, чтобы получить результат работы сервиса в методе result:

curl -X 'GET' \
  'https://latest.dbrain.io/result/96b8ccc950a70699927036842c624d7c?token=XXX' \
  -H 'accept: application/json'

Не забудьте указать в параметре token ваш ключ лицензии. Рекомендуем запрашивать метод result в цикле с периодом 1-2 секунды

Возврат найденных областей изображения

return_crops — boolean

• true — сервис вернёт в ответе API найденные области изображения с печатями и подписями

• false (по умолчанию) —  cервис не вернёт найденные области изображения

Ответ приходит в объект images массива result

Тегирование запроса

task_tags — string array

Поведение по умолчанию: параметр не используется.

Функция тегирует запросы по вашему усмотрению. Это упрощает отслеживание пакетов документов, связанных с конкретным клиентом-физлицом. Для использования функции укажите в параметре task_tags удобный вам тег: task_tags=тэг

Тело запроса к API

Изображение

image — string ($binary)

Изображение обязательно для передачи в запросе. Сервис ожидает изображение документа в двоичном виде

В ответе на запрос к API:

task_id	string	Идентификатор запроса, формат: 32 символа, 16-ричная строка
error	string	Текстовое описание ошибки
task_tags	array[string]	Теги, если они переданы в параметре task_tags
success	boolean	Статус запроса
status_code	integer	HTTP-код статуса запроса 200 — запрос выполнен успешно 400, 403, 500 и т.д. — расшифрованы в «Общей информации о сервисах»
result.images	array[$string]	data URL с MIME-типом JPEG в формате base64 — найденные области изображения с печатями и подписями. Возвращается, если в запросе передать return_crops=true
result.doc_type	string	Всегда возвращается пустым. Оставлен для совместимости структуры ответа с другими методами API
result.confidence	number	Всегда равно 1. Оставлен для совместимости структуры ответа с другими методами API
result.page_num	integer	Номер страницы в оригинальном файле, на котором найдены подписи и печати
result.fields	array	Массив, содержащий найденные подписи и печати
result.fields.name	string	Тип и порядковый номер найденной области изображения. Для печатей это print_X, для подписей это signature_X, где X — порядковый номер
result.fields.value	string	Всегда возвращает «true». Оставлен для совместимости структуры ответа с другими методами API
result.fields.confidence	number	Уровень уверенности сервиса от 0 до 1 в корректности детекции печати или подписи
result.fields.page_num	integer	Номер страницы в оригинальном файле, на котором найдена печать или подпись
result.fields.coords	array[integer]	Массив с координатами поля по четырём точкам: верхний левый угол, верхний правый, нижний левый, нижний правый. Поле может состоять из нескольких частей
result.fields.crops	array[$string]	Массив data URL с MIME-типом JPEG в формате base64 — изображения найденных областей изображения с печатью или подписью. Возвращается, если в запросе передать return_crops=true
result.fields.is_found	boolean	true — поле найдено в документе false — поле в документе не найдено
result.tables	array[array]]	Всегда возвращает пустой массив. Оставлен для совместимости структуры ответа с другими методами API