交互格式说明

更新时间:2023-03-30

1.1 编码格式



• 交互过程中统一使用 UTF-8编码

1.2 请求体



• 请求体格式为UTF-8编码的JSON格式的字符串，如：
• {"number":"1","appId":"mylinl1"}

1.3 公共请求头




User-Agent: alOpenApi Content-Type: application/json; charset=utf-8 accept-encoding: gzip,deflate data-signature: BF706E6AC693BA3B1BABD32E6713431D



• time-stamp: 时间戳, 它是自 1970年1月1日（08:00:00 GMT）至当前时间的总毫秒数。它也被称为Unix时间戳（Unix Timestamp）
• data-signature:请求体通过md5算法生成的签名

注意：值为空的键值对不参与签名

• PHP生成方式



data-signature生成步骤, 示例：php签名示例 $param 为待签名的数组  注意：在签名时 将签名类型加入签名数组中  signType='md5'    签名步骤一：$param按字典序排序参数 ksort($param); 将键值对序列化成：key1=value1&key2=value2&key3=value3 $string = http_build_query($param); 注意：http_build_query函数会对数组中的每一个元素进行序列化URLEncoder 所以其他语言接入一定要进行编码处理 //签名步骤二：在string后加入KEY $string = $string . "&key=1253568ajddkjkf"; 参考格式： appid=123456&nonceStr=123458&signType=md5&timeStamp=1679976183975&key=secret md5加密 $string = md5($string);  //签名步骤四：所有字符转为大写 $result = strtoupper($string);

   

   其他语言请参照该方式进行签名

1.4 响应体



• 响应体格式为UTF-8编码的JSON格式的字符串，如：
• {"number":"1","appId":"mylinl1"}

1.5 Body体公共参数        




appid： '456wwssfgg1233432'    应用ID  请在奥莱开放平台>控制台>接口管理中获取




              nonceStr: '123456789'       随机字符串

              timeStamp：时间戳  它是自 1970年1月1日（08:00:00 GMT）至当前时间的总毫秒数。它也被称为Unix时间戳（Unix Timestamp）

1.6 限流



• 系统会对 相同请求（url+请求体）进行限流，短时间内调用过多相同请求，将报“频繁调用” 错误。
•        限流策略:4分钟相同请求超过50次，将报 频繁调用 错误。
• 如果需要实时通知，可以开通 通知服务，具体请看>通知服务API页面。

1.7 postman及data-signature生成demo

• 1.8.1 postman请求头demo





• 1.8.2 postman请求体demo

• 
  
• 
  
• 
  





• 1.8.3 data-signature 生成demo,md5加密url    
•