请求参数

Header头中传递的参数

参数 参数名 参数描述
Authorization 鉴权信息 鉴权信息规则参见下方规则详细描述。
Auth-Time 当前时间 规则参见下方详细描述。
Rand-Num 随机数 规则参见下方详细描述。
Auth-Ver 版本号 固定值:1.0

header认证参数说明

参数名称 说明 用法
Authorization 认证字符串 生成第一步:将AK、auth_time、rand_num、param_sign 拼接成一个字符串、中间用”\n”分隔。第二步:用SK对第一步生成的字符串做sha1加密,生成authorization
Auth-Ver 认证版本 1.0
Auth-Time 认证时间 表示此次操作的时间,unix系统时间戳(10位)(不能为空,如果请求中的Auth-Time时间和服务器的时间差15分钟以上,服务器将拒绝该服务,并返回ERROR错误)
Rand-Num 随机正整数 表示一个随机正整数(rand生成即可)

Authorization生成规则

  1. $auth_time = time();
  2. $auth_string = $ak . "\n" . $auth_time . "\n" . $rand_num . "\n" . $param_sign;
  3. $encrypt_string = base64_encode(hash_hmac("sha1", $auth_string, $sk, true));
  4. $authorization = $ak . ":" . $encrypt_string;

构造密码串

参数说明 参数名称 说明 用法
auth_time unxi时间戳(10位)
ak Access Key 官网用户中心查看 https://zyun.360.cn/usercenter/user/accesskey
sk Secret Access Key 官网用户中心查看 https://zyun.360.cn/usercenter/user/accesskey
rand_num 随机正整数
param_sign 参数按键排序并加入随机因子 所有参数按key做升序排序后串成字符串$paramStr,然后 $paramStr的md5值连上$rand_num,然后再用md5计算得到的值为param_sign paramStr排序例子: 参数 { a1:v1, b1:v3, a2:v2 } 排序后的字符串为 a1=v1a2=v2b1=v3

错误码

参数说明 参数名称
0 正常
400001 未知错误
400002 系统内部错误
400003 签名错误
400004 参数错误
447000 库名已经存在
447001 库名不存在
447002 创建库失败
447003 删除库失败
447004 查询所有库状态失败
447005 批量添加用户失败
447006 删除用户失败
447008 检索top_k个相似特征失败
447009 检索top_k个相似用户失败
即刻开始使用

只需完成注册与实名认证,即可体验我们的贴心服务