第五十三天：云平台企业协议

冲向天空的猪

• 请求方式：接口基于HTTP/HTTPS协议，可以使用GET、PUT、DELETE等请求方式进行不同的操作。
• 接口地址：接口地址中用号包含的是需要替换的变量，如号包含的是需要替换的变量，如{product_key}、�����值、token值、{did}，使用者需要将具体的值替换进去。
• 请求参数：HTTP请求参数分为Header（在请求头中）、URL（通过url传参）和Body（JSON格式的Request Body）三种类型。
• HTTP请求头部：对于设备管理类和设备报表查询类的接口，需要在请求头中增加token值进行验证。请求头格式如下：
  Content-Type: application/jsonAuthorization: token �����值注意：token值注意：{token值}是具体的token值，不包括${}号。
• HTTP响应头部：接口返回报文头部会输出X-RateLimit-Limit（接口允许访问总量）、X-RateLimit-Remaining（接口剩余访问次数）和X-RateLimit-Reset（调用频率限制重置时间）等信息。
• Token值生命周期：Token值的有效期为7天，通过获取token接口获得的token会包含一个失效日期时间戳（expired_at）。如果当前时间戳大于expired_at时间戳，则需要重新获取token。
• 接口请求配额说明：企业API每小时默认允许调用3600次，超过阈值会抛错，1小时后会恢复接口调用。具体的错误信息可以查看错误信息表中系统编码5013的相关说明。