このトピックでは、Image Search API 操作の共通パラメーターについて説明します。
共通リクエストパラメーター
共通リクエストパラメータは、各 API 操作の HTTP ヘッダーに指定する必要のあるパラメータを参照します。
パラメーター | タイプ | 必須/任意 | 説明 |
---|---|---|---|
Authorization | String | 必須 | リクエストの信頼性をチェックするために使用される認証情報。 文字列は、AccessKeyId:Signature 形式に従う必要があります。 |
Content-Type | String | 必須 | HTTP リクエストのコンテンツタイプ。 値をapplication/x-www-form-urlencoded; charset=UTF-8 に設定します。
|
Content-MD5 | String | 必須 | HTTP メッセージ本文の 128 ビット MD5 ハッシュ値。 ハッシュ値は Base64 にエンコードされています。 |
日付 | String | 必須 | 例えば、HTTP 1.1 で指定されたグリニッジ標準時 (GMT)、Tue 9 Apr 2019 07:35:29 GMT 。
|
Accept | String | 必須 | 必要な戻り値タイプ。 application/json のみがサポートされています。 |
x-acs-signature-nonce | String | 必須 | 反射攻撃を防ぐための、一意の乱数を設定します。 リクエストごとに異なる乱数を使用する必要があります。 |
x-acs-signature-method | String | 必須 | 署名文字列の暗号化方式を設定します。 HMAC-SHA1 のみに対応しています。 |
x-acs-version | String | 必須 | API のバージョン番号。 現在のバージョンは 2019-03-25 です。 |
例
curl -X POST
-H "date:Tue 9 Apr 2019 07:35:29 GMT"
-H "authorization:acs AAAAAAAAAAAAAAAA:rvnQ7UtHSjyMIwo7kirUqAJZdPE="
-H "content-md5:sc/d5c/HBOZdbMdjmaLiEg=="
-H "content-type:application/x-www-form-urlencoded; charset=UTF-8"
-H "x-acs-signature-method:HMAC-SHA1"
-H "x-acs-signature-nonce:123212345678231234"
-H "x-acs-version:2019-03-25"
-H "accept:application/json"
-d "InstanceName=demoinstance&PicName=demo&ProductId=demo&PicContent=..."
"http://imagesearch.cn-shanghai.aliyuncs.com/v2/image/search"
応答パラメーター
リクエストが成功したか否かにかかわらず、各 API リクエストに対してシステムから固有の リクエスト ID が返されます。 次の例を示します:
{
"RequestId": "4C467B38-3910-447D-87BC-AC049166F216",
/* Response data */
}