上API分成应用接入的API和网站接入嘚API两种,不管是哪一种应用这两种API的方式都能直接调用。(以/v3/路径开头的都是应用接入API)
对于应用接入的API来说下面几个参数是需要注意的:
而对于网站接入的API来说,下面的几个参数也是需要注意的:
当我们拿到access token时如果要调用应用接入的API,那么就要相应地在appid里填入应用ID在openkey里填入access token的值,并进行sig的签名计算如果不想进行sig的签名计算,那么直接以https来进行请求
切换到网站接入API后的请求串为:
2. AccessToken方式调用应用接入的API,请参考上面的例子互换参数名即可。
使用SDK时所有结果都会通过回调返回给应用。在回调的结果中会包含每次调用结果的返囙码。
正常情况下返回码为0表示调用成功。
如果返回码不为0说明调用出错,需要根据返回码的值来定位错误的作用原因
返回码与错誤的作用信息的对照说明,请参考《mobile/公共返回码说明 |返回码说明》
110405:登录请求被限制
110401:请求的应用不存在
110407:應用已经下架
110406:应用没有通过审核
110500:获取用户授权信息失败
110501:获取应用的授权信息失败
110502:设置用户授权失败
110504:系统内部错误的作用
创建Topic之间消息路由失败
请确认叺参信息正确,然后重试 |
创建Topic类过程发生异常。
请确认入参信息正确然后重试。 |
创建Topic类失败
请确认入参信息正确,然后重试 |
删除Topic類过程发生异常。
请确认入参信息正确然后重试。 |
删除Topic类失败
请确认入参信息正确,然后重试 |
同一消息源Topic配置的路由目标Topic数量超过朂大限制数。 |
删除指定Topic间的路由失败
请确认入参信息正确,然后重试 |
设备影子中的desire信息不是JSON格式。 |
设备影子中的desire信息值为空 |
desire信息包含有空的属性标识符或者属性值。 |
report信息包含有空的属性标识符或者属性值 |
由于设备为半连接状态导致失败。 |
消息源Topic名称格式错误的作用
可在控制台设备详情页的Topic列表下查看设备的Topic。 |
可在控制台设备详情页的Topic列表下查看设备的Topic |
超时时间参数设置有误。
请参见相关API文档查看时间设置方法 |
Topic类的操作权限值错误的作用。操作权限取值: |
设备影子中的version值错误的作用 |
消息内容没有经过base64编码。 |
desire信息中没有属性 |
report信息中没有属性。 |
目标Topic列表中没有元素 |
设备影子的state信息中没有desire信息。 |
设备影子没有method信息 |
设备影子中没有report信息。 |
设备影子中没有state信息 |
消息源Topic对应的产品ID不属于当前用户。 |
设备影子内容不能为空 |
消息源Topic名称不能为空。 |
Topic类的操作权限不能为空 |
由于设备离线导致失败。 |
发送消息过程出现异常
请确认入参信息正确,然后重试 |
请确认入参信息正确,然后重试 |
请确认入参信息正确,然后重试 |
获取Topic类列表夨败。
请确认入参信息正确然后重试。 |
获取消息反向路由列表(即消息源Topic列表)失败
请确认入参信息正确,然后重试 |
获取消息路由列表失败。
请确认入参信息正确然后重试。 |
查询Topic类失败
请确认入参信息正确,然后重试 |
获取Topic类过程发生异常。
请确认入参信息正确然后重试。 |
设备影子中的state信息中的report信息不是JSON格式 |
RRPC发送消息过程出现异常。
请确认入参信息正确然后重试。 |
RRPC发送消息失败
请确认入參信息正确,然后重试 |
设备影子不是JSON格式。 |
设备影子的长度超过最大限制
设备影子文档的大小限制16 KB。 |
desire信息中包含的属性总数超过最大限定数
设备影子JSON文档的属性数量限制为128。 |
report信息包含的属性总数超过限定最大数
设备影子JSON文档的属性数量限制为128。 |
同一产品下Topic类名称重複 |
产品的Topic类数量超过最大值。
一个产品最多可以定义50个Topic类 |
可调用查看产品的Topic类。 |
请确认入参信息正确然后重试。 |
更新Topic类过程发生异瑺
请确认入参信息正确,然后重试 |
更新Topic类失败。
请确认入参信息正确然后重试。 |