APP接入家长端

APP内嵌图灵内容资源页面，需要先在图灵AI开放平台“自定义家长端”-“微信公众号授权”处配置相应信息。后续根据相关文档完成完整逻辑操作，参见设备接入文档 查看 , 忽略airkiss配网部分，主要查看http接口以及mqtt协议。

接入说明

app端需要加载图灵内容资源页面，入口地址为：

http接入： http://iot-ai.turingapi.com/jump/app/source?apiKey={APIKEY}&uid={APP的用户唯一标识}&client={手机操作系统}  

https接入： https://iot-ai.turingapi.com/jump/app/source?apiKey={APIKEY}&uid={APP的用户唯一标识}&client={手机操作系统} 

若对数据通信有较高的安全要求，建议选择https接入方式来访问图灵服务，由于ssl层验证预计会额外多花费40~50ms。

例如：

http接入： http://iot-ai.turingapi.com/jump/app/source?apiKey=xxx&uid=xxx&client=android
https接入： https://iot-ai.turingapi.com/jump/app/source?apiKey=xxx&uid=xxx&client=android

接口说明

注意请求参数中的uid在同一个apiKey下要保持唯一性，图灵云端会根据uid生成对应的openid（格式如app-1a72263bc1950275ae4619515b34b026），然后进行设备和openid的绑定。

设备绑定

path: /app-author/bind

method: POST

content-type: application/x-www-form-urlencoded

请求参数说明：

参数	类型	是否必须	描述
apiKey	string	是	图灵apiKey，使用图灵服务
uid	string	是	APP的用户唯一标识 和入口地址中的uid保持一致
deviceId	string	是	设备id
name	string	是	用户名称
imageUrl	string	是	用户头像链接

返回结果：

{
    "desc": "success",
    "code": 0
}

返回参数说明：

参数	类型	是否必须	描述
code	int	是	0-success 其他失败
desc	string	是	错误描述

绑定状态查询

path：/app-author/bind_status

method: POST

content-type: application/x-www-form-urlencoded

请求参数说明：

参数	类型	是否必须	描述
apiKey	string	是	图灵apiKey，使用图灵服务
uid	string	是	APP的用户唯一标识 和入口地址中的uid保持一致
deviceId	string	是	设备唯一标识

返回结果：

{
    "desc": "success",
    "code": 0,
    "payload": 0
}

返回参数说明：

参数	类型	是否必须	描述
code	int	是	0-success 其他失败
desc	string	是	错误描述
payload	int	是	0-未绑定 1-已绑定

设备解绑

path: /app-author/unbind

method: POST

content-type: application/x-www-form-urlencoded

请求参数说明：

参数	类型	是否必须	描述
apiKey	string	是	图灵apiKey，使用图灵服务
uid	string	是	APP的用户唯一标识 和入口地址中的uid保持一致
deviceId	string	是	设备唯一标识

返回参数说明：

参数	类型	是否必须	描述
code	int	是	0-success 其他失败
desc	string	是	错误描述

错误码

错误码	描述
-1	其他错误
41002	参数错误
41003	未授权
41004	未绑定
41009	已绑定该设备
41010	已绑定其他设备