All Products
Search
Document Center

Common parameters

Last Updated: Apr 28, 2019

Common request parameters

Common request parameters refer to parameters in an HTTP header, which are required by API operations.

Name Type Required Description
Authorization String Yes The authentication information that is used to check the authenticity of a request. The string must use the AccessKeyId:Signature format.
Content-Type String Yes The type of the content in the HTTP request. Set the value to application/x-www-form-urlencoded; charset=utf-8.
Content-MD5 String Yes The 128-bit MD5 hash value of the HTTP request body, which is encoded by using Base64.
Date String Yes The GMT time specified in HTTP 1.1. Example: Tue 9 Apr 2019 07:35:29 GMT.
Accept String Yes The required type of the returned content. Currently, only application/json is supported.
x-acs-signature-nonce String Yes A unique random number. This parameter is used to prevent replay attacks. You must use different random numbers for different requests.
x-acs-signature-method String Yes The method of the user signature. Currently, only HMAC-SHA1 is supported.
x-acs-version String Yes The API version. The current version is 2019-03-25.

Examples

  1. curl -X POST
  2. -H "date:Tue 9 Apr 2019 07:35:29 GMT"
  3. -H "authorization:acs AAAAAAAAAAAAAAAA:rvnQ7UtHSjyMIwo7kirUqAJZdPE="
  4. -H "content-md5:sc/d5c/HBOZdbMdjmaLiEg=="
  5. -H "content-type:application/x-www-form-urlencoded; charset=UTF-8"
  6. -H "x-acs-signature-method:HMAC-SHA1"
  7. -H "x-acs-signature-nonce:123212345678231234"
  8. -H "x-acs-version: 2019-03-25"
  9. -H "accept:application/json"
  10. -d "InstanceName=demoinstance&PicName=demo&ProductId=demo&PicContent=..."
  11. "http://imagesearch.cn-shanghai.aliyuncs.com/v2/image/search"

Common response parameters

Each time you make a call to an API, the system returns a unique identification code (RequestId), regardless of whether the request is successful.

Examples

JSON format:

  1. {
  2. "RequestId": "4C467B38-3910-447D-87BC-AC049166F216",
  3. /* The response*/
  4. }