このトピックでは、コンテンツモデレーション API を呼び出すために送信される HTTP および HTTPS POST リクエストの構文について説明します。
リクエストメソッド
コンテンツモデレーション API は、HTTP および HTTPS POST リクエストの両方をサポートしています。JSON 形式のリクエストパラメータは、HTTP リクエストボディでサーバーに送信されます。共通クエリパラメータ clientInfo は、URL クエリパラメータで使用できます。
次のコードは、同期画像モデレーションのエンコードされていないリクエストの例を示しています。
http://green.cn-shanghai.aliyuncs.com/green/image/scan?clientInfo={"ip":"127.0.0.2","userId":"120234234","userNick":"Mike","userType":"others"}パラメータ：
http: リクエストの送信に使用されるプロトコル。green.cn-shanghai.aliyuncs.com: コンテンツモデレーション API のエンドポイント。green/image/scan: 特定の操作。この例では、green/image/scan は同期画像モデレーション操作を示します。clientInfo={"ip":"127.0.0.2","userId":"120234234","userNick":"Mike","userType":"others"}: 共通クエリパラメータ。
通信プロトコル
HTTP または HTTPS でリクエストを送信できます。セキュリティレベルを上げるために、特に機密データを扱う場合は、HTTPS でリクエストを送信することをお勧めします。
リクエストパラメータ
各リクエストでは、共通リクエストパラメータと操作固有のサービスリクエストパラメータを指定する必要があります。サービスリクエストパラメータは、リクエストボディで渡されます。ボディ構造の詳細については、各操作の説明を参照してください。
エンコーディング
リクエストとレスポンスはどちらも UTF-8 でエンコードされます。