CLOVA OCR Validation

Classic/VPC環境で利用できます。

CLOVA OCRサービスでは、Template OCRで使用可能な外部検証機能を提供します。この機能を使用するには、まず、NAVERクラウドプラットフォームコンソールの Templateドメインでテンプレートビルダを実行し、表示された画面で検証機能を連携する必要があります。連携後には特定の文書をテンプレートに設定し、文書から抽出した値を外部検証サーバに転送して検証結果を確認します。

参考

検証結果はTemplate OCRレスポンスボディのvalidationResultに反映されます。

リクエスト

リクエスト形式を説明します。

リクエストボディ

CLOVA OCR Builderで外部検証連携を設定すると、画像認識結果受信時に外部検証結果が一緒に送信されます。

参考

詳細は、CLOVA OCRご利用ガイドのOCR Readerをご参照ください。

リクエスト例

リクエストのサンプルコードは次の通りです。

{
  "image": {
    "uid": "{uid}",
    "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` `NO_REQUESTED`: 検証をリクエストしていない `UNCHECKED`: レスポンスを確認しなかったか、レスポンスを受諾していない `ERROR`: 検証実行エラー発生 `VALID`: 結果は有効 `INVALID`: 結果は有効ではない
`message`	String	-	認証結果の詳細メッセージ `result`が`VALID`または`INVALID`の場合に表示

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
  "uid": "{uid}",
  "result": "VALID",
  "message": "VALID message!"
}