Подписи и печати
Проверяем наличие и расположение подписей и печатей на документах, что позволяет быстро отклонять документы, которые забыли подписать.
Чтобы воспользоваться сервисом, отправьте POST-запрос на URL https://latest.dbrain.io/check/sign_seal
Параметры запроса к 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