全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网

公共请求参数

更新时间:2017-06-21 15:27:45

公共请求头(HTTP Header)

所有HTTP的请求中,含有如下公共请求头(HTTP Header):

HTTP头 类型 是否必须 说明
Accept 字符串 必须 接受的返回类型,目前只支持JSON:application/json
Content-Type 字符串 必须 当前请求body的数据类型,目前只支持JSON:application/json
Content-MD5 字符串 必须 根据请求body计算所得,算法为先对body做md5,再做base64编码所得
Date 字符串 必须 GMT日期格式,例如:Tue, 17 Jan 2017 10:16:36 GMT
x-acs-version 字符串 必须 内容安全接口版本,当前版本为:2017-01-12
x-acs-signature-nonce 字符串 必须 随机字符串,用来避免回放攻击
x-acs-signature-version 字符串 必须 签名版本,目前取值:1.0
x-acs-signature-method 字符串 必须 签名方法,目前只支持: HMAC-SHA1
Authorization 字符串 必须 认证方式,取值格式为:”acs” + “ “ + AccessKeyId + “:” + signature。其中AccessKeyId从阿里云控制台申请所得,而signature为请求签名。签名算法参见后面文档1.3说明。

公共查询参数(query parameters)

所有HTTP访问中,请求有如下公共参数(query parameters):

字段 类型 是否必须 说明
clientInfo 字符串 可选 客户端信息,由ClientInfo结构体JSON序列化所得。包括umid/imei等信息,参考下表介绍

ClientInfo有如下字段:

字段 类型 是否必须 说明
sdkVersion 字符串 可选 sdk版本, 通过SDK调用时,需提供该字段
cfgVersion 字符串 可选 配置信息版本, 通过SDK调用时,需提供该字段
userType 字符串 可选 用户账号类型,取值范围为:[“taobao”, “others”]
userId 字符串 可选 用户ID,唯一标识一个用户
userNick 字符串 可选 用户昵称
avatar 字符串 可选 用户头像
imei 字符串 可选 硬件设备码
imsi 字符串 可选 运营商设备码
umid 字符串 可选 设备指纹
ip 字符串 可选 该IP应该为公网IP;如果请求中不填写,服务端会尝试从链接或者http头中获取。如果请求是从设备端发起的,该字段通常不填写;如果是从后台发起的,该IP为用户的login IP或者设备的公网IP
os 字符串 可选 设备的操作系统,如:’Android 6.0’
channel 渠道号 可选 渠道号
hostAppName 字符串 可选 宿主应用名称
hostPackage 字符串 可选 宿主应用包名
hostVersion 字符串 可选 宿主应用版本
本文导读目录