すべてのプロダクト
Search

このプロダクト

    ID Verification:CREDENTIAL_DETECT

    ドキュメントセンター

    ID Verification:CREDENTIAL_DETECT

    最終更新日:Sep 11, 2026

    このトピックでは、証明書画像を分析し、偽造、改ざん、スクリーンショット、画面の撮影などのリスクを検出する証明書検出 API について説明します。

    API 情報

    • API 名：CredentialVerifyIntl

    • 説明：証明書画像から、偽造、改ざん、スクリーンショット、画面の撮影などのリスクを検出します。

    • リクエストメソッド：POST

    • プロトコル：HTTPS

    • QPS 制限：各 API には専用の QPS 制限があります。詳細は、「ID Verification サーバー側 API の QPS 制限」をご参照ください。

    • サービスアドレス：

      説明

      • 内部ネットワークアクセスのメリット：内部ネットワークを使用すると、同じリージョン内の Alibaba Cloud サービス間でプライベートな通信が可能になります。ご利用のアプリケーションサーバーも同じリージョンにある場合は、内部ネットワークエンドポイントを使用して ID Verification サービスにアクセスすることで、より安全で安定した接続が実現します。

      • 海外アクセスの最適化：中国本土以外のネットワーク環境は複雑な場合があります。遅延を減らし、リクエストの失敗を最小限に抑えるには、「サーバー側のネットワーク遅延分析と最適化」のベストプラクティスに従って統合を最適化してください。

      シンガポール

      • パブリックエンドポイント：cloudauth-intl.ap-southeast-1.aliyuncs.com

      • 内部エンドポイント：cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    説明

    1. 証明書検出は AI を活用した予測サービスです。内部テストデータセットでは 90% の精度を達成しています。実際の精度は、具体的なシナリオや画像サンプルにより異なる場合があります。

    2. 本サービスは、デジタル生成または編集された画像よりも、カメラで撮影された画像の加工を検出する際により効果的です。

    3. 検出結果は、証明書の真正性を判断する唯一の根拠ではありません。手動レビューの効率を向上させる補助ツールとして使用してください。

    4. 証明書検出は、決済代行や E コマースの出店者オンボーディングなどのシナリオの電子ドキュメント審査で広く使用されています。手動レビューの効率を効果的に向上させます。その他のユースケースに関する要件がある場合は、アカウントマネージャーにお問い合わせください。

    オンラインデバッグと連携

    説明

    デバッグまたは統合を行う前に、「OpenAPI を使用したサーバー側 API のデバッグと統合」ガイドを読み、OpenAPI プラットフォームでの API の呼び出し方法と SDK の取得方法を理解してください。

    この API は、OpenAPI Explorer を使用してオンラインでデバッグでき、さらにSDK コード例も生成できます。

    リクエストパラメーター

    ImageUrl または ImageFileObject パラメーターで指定する画像は、次の要件を満たす必要があります：

    • 画像形式：PNG、JPG、JPEG、BMP、WebP。

    • 画像の幅と高さは、いずれも15 ピクセル超、8192 ピクセル未満である必要があります。縦横比は 50 未満である必要があります。

      説明

      最適な検出結果を得るために、画像の幅と高さはいずれも 500 ピクセルを超えることを推奨します。

    • 画像ファイルサイズ：ImageUrl を使用する場合は 10 MB、ImageFileObject を使用する場合は 3 MB を超えないようにしてください。

      説明

      画像が大きいと API の応答時間が増加する場合があります。3 MB 未満の画像の使用を推奨します。

    パラメーター

    型

    必須

    説明

    例

    CredType

    String

    はい

    証明書のタイプ。有効な値：

    • 03：企業資格

    • 04：取引証明書

    03

    CredName

    String

    はい

    証明書名を示す数値コード。有効な値：

    • 企業資格は 03 で始まります：

      • 0301：中国本土の営業許可証

    • 取引証明書は 04 で始まります：

      • 0401：銀行取引記録

      • 0402：給与明細

      • 0403：公共料金の請求書

      • 0405：クレジットカード請求書

      • 0499：その他

    説明

    追加の証明書タイプのサポートが必要な場合は、アカウントマネージャーにお問い合わせください。

    0301

    ProductCode

    String

    はい

    呼び出しモード。有効な値：

    • ANTI_FAKE_CHECK：画質チェックと改ざん検出。

    ANTI_FAKE_CHECK

    ImageUrl

    String

    はい

    重要

    ImageUrl または ImageFileObject のいずれかのパラメーターを指定してください。

    画像の URL。

    https://example.com/test.jpg

    ImageFileObject

    InputStream

    画像ファイルのストリーム。

    このパラメーターを使用してファイルをアップロードするには、Advance API を呼び出し、有効な InputStream オブジェクトを渡す必要があります。詳細については、「特殊なシナリオ：ファイルアップロードのための Advance API の設定」をご参照ください。

    画像を表す InputStream オブジェクト。

    レスポンスパラメーター

    パラメーター

    型

    説明

    例

    RequestId

    String

    リクエスト ID。

    130A2C10-B9EE-4D84-88E3-5384********

    Code

    String

    レスポンスコードです。詳細については、「サーバーサイド HTTP ステータスコード」をご参照ください。

    重要

    • このパラメーターは、API 呼び出しが成功したかどうかを示します。

    • ビジネス検証結果については、ResultObject のフィールドを確認してください。

    Success

    Message

    String

    レスポンスコードの詳細な説明。

    success

    ResultObject

    Result

    String

    • 0：低リスク

    • 1：高リスク

    • 2：疑わしい

    1

    RiskTag

    String

    リスクタグ。複数のタグはカンマ (,) で区切られます。有効な値：

    • PS：編集された画像

    • SCREEN_PHOTO：画面の撮影

    • SCREENSHOT：スクリーンショット

    • ORIGINAL_PHOTO：原本ではない画像

    PS

    RiskScore

    Map<String, String>

    各リスクタグの予測リスクスコア。値の範囲は 0～1 です。スコアが高いほど、該当するリスクの可能性が高いことを示します。

    {
  "PS": "0.0211",
  "SCREEN_PHOTO": "0.0101",
  "SCREENSHOT": "0.0521",
  "ORIGINAL_PHOTO": "0.0861"
}

    MaterialInfo

    String

    その他の情報。このパラメーターは予約されています。