京东智能家居云对接方案V13.docVIP

京东智能家居云对接方案 文档信息 文档名称： 京东智能家居云对接方案 初稿作者： 张卫锋 初稿日期： 2014-05-22 内容概述： 为方便厂商接入京东智能云，特提供此文档与厂商。 修订历史 版本 修订日期 修订人 复核日期 复核人 修改内容简述 V1.0 2014-05-22 张卫锋 新建 V1.1 2014-05-28 雒根雄 新增https证书 V1.2 2014-05-28 张卫锋 心跳间隔最小时间修订为1分钟 V1.3 2014-09-17 沈剑 调整设备发现、激活、绑定方式 S 2014-05-22  目录 京东智能家居云对接方案 1 1. 整体介绍 4 2. 申请开发者 4 2.1 申请加入 4 2.2 创建产品 5 3. 智能设备与京东智能云通讯 6 3.1 设备出厂设置 6 3.2 设备激活（HTTPS） 6 3.3 设备正常上数（HTTPS） 6 3.4 长连接（SSL） 6 3.4.1 长连接心跳 7 3.4.2 设备受控 7 3.5 https的证书 8 4. 样例示范 8 4.1 产品创建 9 4.2 与京东智能云交互 9  词 注解 厂商 本文档代指接入京东智能云设备的硬件厂商，创业团队，极客等。 product_id 厂商在京东智能云后台创建一类“产品”时，由京东智能云分配，作为一类产品的唯一标识码。 product_uuid 由京东智能云分配的6位随机的英文或字母组成，与product_id对应的产品唯一标识码。 product_secret 与product_id一起分配于厂商，作为以后产品认证密钥。 device_id 厂商对自己产品的标识码，即设备序列号，同一产品（product_id）下device_id不可重复。 feed_id 京东智能云对连入智能设备的唯一标识码，由京东智能云统一分配,用于数据交换等。 access_key 与feed_id一起同时由京东智能分配，是数据交换的认证密钥，厂商在设备上请妥善保存。 stream_id 每一个产品都由不同的参数组成，参数的标识即stream_id,如一台智能空调，一个stream_id为“switch”,用于表示设备的开关。 APP 代表京东智能云APP－京东云助手  整体介绍 厂商对接京东智能云的流程图如下 申请开发者 京东智能云线上地址为： 智能硬件厂商要加入京东智能云，第一步要申请成为京东智能云开发者。 申请加入 请发邮件到smartcloud@，申请成为京东智能云开发者账号。 邮件格式如下： 1. 邮件标题：XXX申请成为京东智能云开发者 2. 您的京东账号 3. 您的联系方式 4. 您的产品介绍、使用说明等 以上的京东账号指京东账号体系内的京东用户名，建议您使用以下方式确认后再发送邮件。 登录/user/info 下图箭头所指位置即为京东用户名，使用此用户名可申请成为京东智能云开发者。 创建产品 京东智能云运营人员收到申请邮件后，会即时开通开发者权限。并回复厂商的申请邮件。 厂商收到审核通过邮件后，通过开通的开发者账号登录如下地址创建产品： /dev/index 此时，一级菜单将出现“产品管理”栏目。如下图： 点击后进入产品管理页，厂商可录入产品信息。 产品信息包括两部分，第一部分为产品的名称，图片等基础信息，请参考每行右侧的注释，填写即可。 第二部分是产品参数（stream），厂商的智能设备与京东智能云信息交互是通过产品参数来实现的，建议厂商阅读全文理解京东智能云理念后，再行创建产品参数。 创建成功后，厂商会得到产品号和密码，示例如下： 智能设备与京东智能云通讯 设备出厂设置 设备出厂前，厂商需要将上步获得的product_uuid及设备序列号device_id写入设备，此二项将做为与京东智能云通讯接口的必须参数。 与京东智能云的通讯需要智能设备同时支持HTTPS和SSL长连接两种方式。 设备发现 设备在出厂设备完成，嵌入式程序完成后，第一次使用前需要进行设备发现。 设备需要在产品包装或说明书等的地方附上设备的二维码，二维码包括京东product_uuid。 二维码格式：/download?b=urlencode(base64 (productuuid)) 设备必需要满足京东的设备发现协议，目前古北、汉枫、庆科的WIFI模块均已经实现了该协议。协议接口详见“JD内部文档--设备发现接口.pdf”。 设备激活 JD超级App 用户可使用京东超级App进行设备的激活操作。 第三方App 第三方App可通过调用京东开放服务（JOS）的授权认证接口使用京东用户进行登录，然后调用设备激活接口进行设备激活。（接口URL、参数等略） 京东开放服务参考： 执行