本文档的目标用户为支付宝ISV设备接入开发人员,旨在实现支付宝IOT云端提供的设备注册激活快速接入。
快速接入文档参考《蚂蚁平台快速接入》。
com.alipay.api.request.AlipayCommerceIotMdeviceprodDeviceInitializeRequest
注册激活接口主要使用于:
(1) 无SDK;
(2) 带SDK2.0设备,但SDK激活失败的场景,可以通过该接口辅助激活(SDK1.0设备不能使用该接口辅助激活)。
注册激活接口适用的行业:
团餐、快消、停车、智能售卖、K12、公交、客运、餐饮、医疗、政务、未来校园、酒店、高速、间联设备。
请求参数文档及示例参考这里
key | 描述内容 | 可选值 | demo |
---|---|---|---|
pay_channel | 奥比摄像头单双通道字段 | single—单通道 double—双通道 |
double |
supplier_expansion | 供应商是否自采 | Y——自己采购 N——非自采 |
Y |
TIPS:ext_info字段使用json格式传输,例如{“pay_channel”:“double”,“supplier_expansion”:“Y”}
通用错误码 | 通用错误信息 | 详细错误信息 | 详细错误原因 |
---|---|---|---|
INVALID_PARAMETER | 参数有误 | device_sn缺失 | 参数device_sn必填 |
INVALID_PARAMETER | 参数有误 | supplier_id缺失 | 参数supplier_id必填 |
INVALID_PARAMETER | 参数有误 | item_id缺失 | 参数item_id必填 |
INVALID_PARAMETER | 参数有误 | imei或mac缺失 | 参数imei或mac二选一必填 |
ITEM_UNEXISTS | 物料不存在 | item_id无效 | 参数item_id无效,与支付宝内提供的物料id不符 |
SUPPLIER_UNEXISTS | 供应商不存在 | supplier_id无效 | 参数supplier_id无效,与支付宝内提供的供应商id不符 |
REGISTER_ERROR | 注册执行错误 | 注册执行错误 | 需提供具体错误内容供支付宝同学分析 |