すべてのプロダクト
Search

このプロダクト

    AI Guardrails:共通パラメーター

    ドキュメントセンター

    AI Guardrails:共通パラメーター

    最終更新日:Aug 26, 2026

    Content Moderation へのすべての HTTP リクエストには、共通のリクエストヘッダーとクエリパラメーターのセットが含まれています。これらの共通パラメーターを、各 API オペレーションのトピックで説明されているオペレーション固有のパラメーターと組み合わせて使用します。

    共通リクエストヘッダー

    次の表では、Content Moderation 検出 API リクエストの共通リクエストヘッダーについて説明します。

    パラメーター

    タイプ

    必須

    説明

    Accept

    String

    はい

    返される結果のタイプ。JSON タイプのみがサポートされています。有効な値： application/json。

    Content-Type

    String

    はい

    リクエストボディのデータ型。JSON タイプのみがサポートされています。有効な値： application/json。

    Content-MD5

    String

    いいえ

    リクエストボディの Base64 エンコードされた MD5 ハッシュ。アルゴリズム：リクエストボディのコンテンツを文字列として扱い、MD5 エンコーディングを適用してバイナリ形式のデータを取得し、その後 Base64 エンコーディングを適用します。

    説明

    暗号化アルゴリズムが HMAC-SM3 に設定されている場合、このフィールドは空白のままにできます。暗号化アルゴリズムが HMAC-SHA1 (デフォルト) に設定されている場合、このフィールドは必須です。

    Date

    String

    はい

    リクエストが作成された時刻。値は GMT 形式で指定します。例： Tue, 17 Jan 2017 10:16:36 GMT。

    x-acs-version

    String

    はい

    Content Moderation API のバージョン番号。有効な値： 2018-05-09。2018-05-09 より前のバージョンは廃止されました。古いバージョン番号を使用すると、リクエストは HttpCode:400 , ErrorCode:InvalidAction.NotFound を返します。バージョン番号を 2018-05-09 に変更してください。

    x-acs-signature-nonce

    String

    はい

    署名ノンス。ネットワークリプレイ攻撃を防ぎます。各リクエストで異なる乱数を使用することを推奨します。

    x-acs-signature-version

    String

    はい

    署名アルゴリズムのバージョン。有効な値： 1.0。

    x-acs-signature-method

    String

    はい

    署名方法。有効な値：- HMAC-SHA1 (デフォルト) - HMAC-SM3 署名方法の詳細については、「リクエスト署名」をご参照ください。

    x-acs-content-sm3

    String

    いいえ

    リクエストボディの SM3 ハッシュを 16 進文字列に変換したもの。アルゴリズム：リクエストボディのコンテンツを文字列として扱い、SM3 暗号化を適用してバイト配列を取得し、そのバイト配列を 16 進文字列に変換します。つまり、encodeHexString(SM3Digest(body)) です。

    Authorization

    String

    はい

    認可方法。形式は "acs" + " " + AccessKeyId + ":" + signature です。パラメーター：- AccessKeyId：Alibaba Cloud 管理コンソールで取得した AccessKey ID。AccessKey ID の取得方法の詳細については、「AccessKey の作成」をご参照ください。- signature：リクエスト署名。リクエスト署名の計算方法の詳細については、「リクエスト署名」をご参照ください。

    共通リクエストパラメーター

    次の表では、Content Moderation 検出 API リクエストの共通クエリパラメーターについて説明します。

    パラメーター

    タイプ

    必須

    説明

    clientInfo

    String

    いいえ

    リクエストを送信したクライアントに関する情報。値は、ClientInfo 構造体を JSON シリアル化して取得し、UMID や IMEI などの情報が含まれます。構造については、「clientInfo」をご参照ください。

    clientInfo パラメーターには、次のフィールドが含まれます：

    パラメーター

    タイプ

    必須

    説明

    sdkVersion

    String

    いいえ

    SDK のバージョン番号。SDK を使用して呼び出す場合にこのフィールドを指定します。詳細については、「SDK の概要」をご参照ください。

    cfgVersion

    String

    いいえ

    設定情報のバージョン。SDK を使用して呼び出す場合にこのフィールドを指定します。詳細については、「SDK の概要」をご参照ください。

    userType

    String

    いいえ

    ユーザーアカウントのタイプ。有効な値：- taobao：Taobao アカウント。- [others]：別のアカウントシステムのアカウント。

    userId

    String

    いいえ

    ビジネスシステムにおけるユーザーの一意の識別子。ユーザーの違反分析のために、この値を指定することを強く推奨します。

    userNick

    String

    いいえ

    ユーザーのニックネーム。

    imei

    String

    いいえ

    デバイスの国際移動体装置識別番号 (IMEI)。

    imsi

    String

    いいえ

    デバイスの国際移動体加入者識別番号 (IMSI)。

    umid

    String

    いいえ

    デバイスの一意のマシン識別子 (UMID)。

    ip

    String

    いいえ

    ユーザーに関連付けられたパブリック IP アドレス。リクエストがデバイスから発信される場合、通常このフィールドは空白のままにします。リクエストがバックエンドから発信される場合、このフィールドをユーザーのサインイン IP アドレスまたはデバイスのパブリック IP アドレスに設定します。ユーザーの違反分析のために、この IP アドレスを指定することを推奨します。リクエストで指定しない場合、サーバーはリクエスト URL または HTTP リクエストヘッダーから IP アドレスの取得を試みます。

    os

    String

    いいえ

    デバイスのオペレーティングシステムのタイプ。例： Android 6.0。

    channel

    String

    いいえ

    チャネル ID。

    hostAppName

    String

    いいえ

    ホストアプリケーションの名前。

    hostPackage

    String

    いいえ

    ホストアプリケーションのパッケージ名。

    hostVersion

    String

    いいえ

    ホストアプリケーションのバージョン。

    リクエスト例

    POST /green/image/scan?clientInfo=%7b%22userId%22%3a%22120234234%22%2c%22userNick%22%3a%22%E5%A4%AA%E9%83%8E%22%2c%22userType%22%3a%22Others%22%7d HTTP/1.1
Accept: application/json
Content-Type: application/json
Content-MD5: C+5Y0crpO4sYgC2DNjycug==
Date: Tue, 15 May 2018 10:16:36 GMT
x-acs-version: 2018-05-09
x-acs-signature-nonce: adfkjfaHKslkjf
x-acs-signature-version: 1.0
x-acs-signature-method: HMAC-SHA1
Authorization: acs q23Q9K4PaGi12Wyk:adFff0FFO6sGcDbDNjRtso==
Host: green.cn-shanghai.aliyuncs.com
Content-Length: 191
{
    "scenes": [
        "porn"
    ],
    "tasks": [
        {
            "dataId": "test2NInmO$tAON6qYUrtCRgLo-1mwxdi",
            "url": "https://img.alicdn.com/tfs/TB1urBOQFXXXXbMXFXXXXXXXXXX-1442-257.png"
        }
    ]
}

    リクエストには、次のコンポーネントが含まれます：

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

    • /green/image/scan ：リクエストパス。

    • clientInfo=%7b%22userId%22%3a%22120234234%22%2c%22userNick%22%3a%22%E5%A4%AA%E9%83%8E%22%2c%22userType%22%3a%22Others%22%7d ：エンコードされた共通リクエストパラメーター。

    • Accept: application/json から Content-Length: 191 までの行：リクエストヘッダー。このうち、Accept: application/json から Authorization: acs q23Q9K4PaGi12Wyk:adFff0FFO6sGcDbDNjRtso== までのヘッダーは、署名の計算に使用される共通リクエストヘッダーです。

    • {} 内のコンテンツ：JSON 形式のリクエストボディ。リクエストボディの構造は、各 API オペレーションの定義によって異なります。特定の API オペレーションのドキュメントをご参照ください。