개요
CLOVA OCR은 인식된 텍스트 값을 외부 서버를 통해 검증할 수 있는 외부 검증 기능을 제공하고 있습니다.
NCP 콘솔의 도메인에서 Template OCR에 제공되는 템플릿 빌더를 클릭하여 외부 검증 기능을 연동할 수 있습니다. 이후 특정 문서를 템플릿으로 설정한 다음, 우편번호 등 문서에서 추출한 값을 외부 검증서버로 보내면 검증 결과를 VALID 또는 INVALID로 수신할 수 있습니다.
검증 결과값은 Template OCR 응답 바디 의 "validationResult" 객체에 반영됩니다.
요청
요청 바디
CLOVA OCR Builder에서 외부 검증 연동을 설정하면 이미지 인식 결과 수신 시 외부 검증 결과가 함께 제공됩니다.
요청 예시
{
"image": {
"uid": "5bbb6c342f054b25a8af898b09bd1122",
"name": "Test-Request",
"inferResult": "SUCCESS",
"message": "SUCCESS",
"matchedTemplate": {
"id": 266,
"name": "EN-Front-2020"
},
"validationResult": {
"result": "UNCHECKED"
},
"title": {
"name": "2020 EN2B-Front",
"boundingPoly": {
"vertices": [
{
"x": 1148.3334,
"y": 23.833334
},
{
"x": 1423.5,
"y": 23.833334
},
{
"x": 1423.5,
"y": 47.666668
},
{
"x": 1148.3334,
"y": 47.666668
}
]
},
"inferText": "2020EN2B-Front",
"inferConfidence": 0.99994594
},
"fields": [
{
"name": "1-Value",
"valueType": "ALL",
"boundingPoly": {
"vertices": [
{
"x": 132.16667,
"y": 491.83334
},
{
"x": 197.16667,
"y": 491.83334
},
{
"x": 197.16667,
"y": 546.0
},
{
"x": 132.16667,
"y": 546.0
}
]
},
"inferText": "FIRST\nMIDDLE\nNAME",
"inferConfidence": 0.99935573,
"type": "NORMAL"
},
{
"name": "2-Value",
"valueType": "NUMERIC",
"boundingPoly": {
"vertices": [
{
"x": 223.98764,
"y": 1148.0485
},
{
"x": 263.99146,
"y": 1148.049
},
{
"x": 263.99606,
"y": 1212.0457
},
{
"x": 223.99258,
"y": 1212.045
}
]
},
"inferText": "",
"inferConfidence": 0.84649235,
"type": "NORMAL"
},
{
"name": "3-Value",
"valueType": "ALL",
"boundingPoly": {
"vertices": [
{
"x": 348.0137,
"y": 1376.034
},
{
"x": 507.0252,
"y": 1376.0349
},
{
"x": 507.0269,
"y": 1416.0331
},
{
"x": 348.01614,
"y": 1416.0322
}
]
},
"inferText": "",
"inferConfidence": 0.9938921,
"type": "MULTI_BOX",
"subFields": [
{
"boundingPoly": {
"vertices": [
{
"x": 348.0137,
"y": 1376.034
},
{
"x": 385.51636,
"y": 1376.0349
},
{
"x": 385.51862,
"y": 1416.0306
},
{
"x": 348.01614,
"y": 1416.0298
}
]
},
"inferText": "",
"inferConfidence": 0.999991
},
{
"boundingPoly": {
"vertices": [
{
"x": 388.51654,
"y": 1376.0349
},
{
"x": 426.01926,
"y": 1376.0356
},
{
"x": 426.02133,
"y": 1416.0315
},
{
"x": 388.51883,
"y": 1416.0306
}
]
},
"inferText": "",
"inferConfidence": 0.98254
}
]
}
]
}
}
응답
응답 바디
| 필드명 | 유형 | 설명 |
|---|---|---|
| uid | string | 요청 바디의 uid와 같은 값이 표시됨 |
| result | string | 인증 결과가 표시됨NO_REQUESTED: 검증 작업을 요청하지 않음UNCHECKED: 동작 응답이 확인되지 않거나 응답 미수락ERROR: 검증 실행에 오류 발생 VALID: 검증 결과가 유효함 INVALID: 검증 결과가 유효하지 않음 |
| message | string | 인증 결과에 대한 세부 메시지 결과값이 VALID 또는 INVALID인 경우 표시됨 |
응답 예시
{
"uid": "5bbb6c342f054b25a8af898b09bd1122",
"result": "VALID",
"message": "VALID message!"
}