文档中心 > IOT设备云端接入

IOT设备绑定解绑接入文档

更新时间：2019/03/28 访问次数：7160

1.概述
2.快速接入
3.绑定接口
4.解绑接口

1.概述

本文档的目标用户为支付宝ISV设备接入开发人员，旨在实现支付宝IOT云端提供的设备绑定解绑快速接入。

2.快速接入

快速接入文档参考《蚂蚁平台快速接入》。

3.绑定接口

3.1 绑定接口类

com.alipay.api.request.AlipayCommerceIotMdeviceprodDeviceBindRequest

3.2 绑定请求参数

请求参数文档及示例参考这里

3.3 行业绑定关系说明

行业场景	绑定关系必填类型
停车场	PARKING
政务	AFFAIRS
智能售卖	COMMON_MERCHANT、COMMON_SHOP
酒店	COMMON_SHOP
公交	COMMON_SHOP
客运	COMMON_SHOP
长尾(小蓝盒)	ALIPAY_USERID
间联设备	SEPERATE_MERCHANT
其他	COMMON_MERCHANT或者COMMON_SHOP或都填

3.4 绑定返回错误码

通用错误码	通用错误信息	详细错误信息	详细错误原因
INVALID_PARAMETER	参数有误	类型错误	参数identify_type只能选SN或ID
INVALID_PARAMETER	参数有误	biz_tid参数缺失	参数biz_tid在identify_type为ID时必填
INVALID_PARAMETER	参数有误	device_sn、supplier_id 参数缺失	参数device_sn、supplier_id在identify_type为SN时必填
INVALID_PARAMETER	参数有误	绑定关系参数缺失	参数principal必填
INVALID_PARAMETER	参数有误	绑定关系类型取值非法	参数principal中每项type必须在可选项中
INVALID_PARAMETER	参数有误	绑定关系id必填	参数principal中每项id必填
INVALID_PARAMETER	参数有误绑定关系缺失	停车场绑定关系缺失	停车场机具缺少type为PARKING的绑定关系
INVALID_PARAMETER	参数有误绑定关系缺失	政务绑定关系缺失	政务机具缺少type为AFFAIRS的绑定关系
INVALID_PARAMETER	参数有误绑定关系缺失	智能售卖商户或门店绑定关系缺失	停车场机具缺少type为COMMON_MERCHANT和COMMON_SHOP的绑定关系
INVALID_PARAMETER	参数有误绑定关系缺失	生产厂商绑定关系缺失	泛行业机具缺少type为COMMON_PRODUCT的绑定关系
INVALID_PARAMETER	参数有误绑定关系缺失	[……]门店绑定关系缺失	酒店、公交、客运机具缺少type为COMMON_SHOP的绑定关系
INVALID_PARAMETER	参数有误绑定关系缺失	长尾机具用户绑定关系缺失	长尾机具缺少type为ALIPAY_USERID的绑定关系
INVALID_PARAMETER	参数有误绑定关系缺失	间联设备商户绑定关系缺失	长尾机具缺少type为SEPERATE_MERCHANT的绑定关系
INVALID_PARAMETER	参数有误绑定关系缺失	[……]商户或门店绑定关系缺失	缺少type为COMMON_MERCHANT或COMMON_SHOP的绑定关系
BIZ_ERROR	业务异常	具体参考返回内容	请联系技术人员
DEVICE_UNEXISTS	设备不存在	设备不存在	未查询到设备信息，请检查机具是否注册

3.5 行业绑定参数说明

行业	参数名	参数描述	demo
停车行业	scanMode	机具扫码模式：code–扫码，pos–POS模式	ext_info:{“scanMode”:“code”}

4.解绑接口

4.1 解绑接口类

com.alipay.api.request.AlipayCommerceIotMdeviceprodDeviceUnBindRequest

4.2 解绑请求参数

请求参数文档及示例参考这里

4.3 行业解绑关系说明

同【3.3行业绑定关系说明】,解绑时输入的principal参数必须与绑定时一致，否则会解绑失败

4.4 行业解绑返回错误码

同【3.4行业绑定返回错误码】,解绑时返回错误码与绑定时错误码基本相同，特殊返回错误码如下：

通用错误码	通用错误信息	详细错误信息	详细错误原因
PRINCIPAL_MISMATCH	待解绑绑定关系与原绑定关系不匹配		当前输入解绑关系与机具已绑定关系不符，不允许解绑

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

开放平台

IOT设备云端接入