适用于超高频芯片的通用接口,不局限于某款芯片。
背景信息
超高频RFID只能与特殊的超高频读写设备交互,无法通过手机识别。由阿里云提供服务端接口,超高频读写器厂商进行集成和适配,已完成适配的读写器型号会陆续更新。
目前超高频RFID提供了四个能力:
发行安全EPC
认证安全EPC
发行安全标识码
认证安全标识码
超高频读写器开发
设备端接口
由读写器设备商自行集成。
服务端接口
发行安全EPC
接口形式:Restful。
接口地址:/uhf/1/issue/96epc。
功能描述:发行阿里云标准96 bit超高频RFID安全EPC,用于写入芯片的EPC区域
请求方式:POST
参数格式:application/json
参数说明:
名称
类型
是否必选
取值要求
示例值
描述
customerId
String
是
16位字符
143496402717****
阿里云账号UID。
serviceId
String
是
10位字符
123456****
IoT安全中心创建的项目serviceId。
tagId
String
是
24位字符
D854A8559F7046D4BEF0****
超高频RFID的唯一ID(96 bit),为24位十六进制字符。
输入参数示例:
{ "customerId": "143496402717****", "serviceId": "123456****", "tagId": "D854A8559F7046D4BEF0****", }
返回参数示例:
{ "code": "00", //结果码, "00"表示成功,其他值参照错误码表 "msg": "success", //结果消息 "data": { // 当code为"00"时,data对象不为空 "encSessionKeyBase64": "vwm/hoaQ4ZaNCdr9fCdwWL2xHI0TUOkdgc2upi4vSBfO52dE8RBxy9J+rFVpsMIVdlSpd2w70dIVRinaet+V8OXIThTGkd1/ezr0D4FO2MPgVVNp1gAj0FzpYoRsuR/8ose88brzyy15pLcf41P6/jXIQaLGqG0TOn1LnYA****=", //被公钥经RSA1024算法加密后的session key "encDataBase64": "vCCaehK8kfopfKNARxe46z2zxWzBbYEWunHlr5Hswnm2cXHeU7lm7ckcn9zOT6Gq3yOlDLZWcuXE2kyGydnkfJiLPxcKZUvZrTS2llwwq4M4IE6UuZa/jQsCZWsr7pHja3qoGWgOJIzdLngps****==" //被session key经AES128算法加密后的EPC值 }, "failed": false, "success": true }
认证安全EPC
接口形式:Restful
接口地址:/uhf/1/auth/96epc
功能描述:对阿里云发行的标准96 bit超高频RFID安全EPC进行认证
请求方式:POST
参数格式:application/json
参数说明:
名称
类型
是否必选
取值要求
示例值
描述
customerId
String
是
16位字符
143496402717****
阿里云账号UID。
serviceId
String
是
10位字符
123456****
IoT安全中心创建的项目serviceId。
tagId
String
是
24位字符
ACB0B7302D6C7CD7010A****
超高频芯片的UID,为24位十六进制字符。
epc
String
是
24位字符
A58C0BE6D3234386A8B9****
阿里云发行的安全EPC,为24位十六进制数。
输入参数示例
{ "customerId": "143496402717****", "serviceId": "123456****", "tagId": "ACB0B7302D6C7CD7010A****", "epc": "A58C0BE6D3234386A8B9****", }
返回参数示例
{ "code": "00", //结果码, "00"表示成功,其他值参照错误码表 "msg": "success", //结果消息 "data": { // 当code为"00"时,data对象不为空 "tagId": "ACB0B7302D6C7CD7010A****", // 与请求参数中的tagId一致 "epc": "A58C0BE6D3234386A8B9****" // 与请求参数中的epc一致 }, "failed": false, "success": true }
发行安全标识码
接口形式:Restful
接口地址:/uhf/1/issue/32sc
功能描述:发行阿里云超高频RFID安全码,用于写入RFID芯片的user区域
请求方式:POST
参数格式:application/json
参数说明:
名称
类型
是否必选
取值要求
示例值
描述
customerId
String
是
16位字符
143496402717****
阿里云账号UID。
serviceId
String
是
10位字符
123456****
IoT安全中心创建的项目serviceId。
tagId
String
是
24位字符
ACB0B7302D6C7CD7010A****
超高频芯片的UID,为24位十六进制字符。
输入参数示例
{ "customerId": "143496402717****", "serviceId": "123456****", "tagId": "ACB0B7302D6C7CD7010A****", }
返回参数示例
{ "code": "00", //结果码, "00"表示成功,其他值参照错误码表 "msg": "success", //结果消息 "data": { // 当code为"00"时,data对象不为空 "encSessionKeyBase64": "n52HM55wHJ97fz2I9iLUkFa9Cbf30lGClMOG/aw2Z+FUdDyBOtGLc47Ar+iGFn4wYlqX1k0MzK7BB80Tj61SB/PCcjjsFriM4qIKR4NNZqVnyL+IM3vNMcKhddFRILM5lrdNADtRPWpntupfZT+xNUIhjH5n0/V25YGY4h****=", //被公钥经RSA1024算法加密后的session key "encDataBase64": "nLsZoR6GdjPmUw0vpzFhBTX+d8w71K3BDsgPgUFsuTcuO0e3PFdeLZ2ZRmPsOMRm88Cth1cNQi0u23TsC4lh19VQK89uo8ZzFWDhxrE6j7O8mvEy9Tw8uN0MsOm2ERZuTGEJrfcuq+ZQXr8TAQ****==" //被session key经AES128算法加密后的secure code }, "success": true, "failed": false }
认证标识
接口形式:Restful
接口地址:/uhf/1/auth/32sc
功能描述:对阿里云发行的标准超高频RFID安全码进行认证
请求方式:POST
参数格式:application/json
参数说明:
名称
类型
是否必选
取值要求
示例值
描述
customerId
String
是
16位字符
143496402717****
阿里云账号UID。
serviceId
String
是
10位字符
123456****
IoT安全中心创建的项目serviceId。
tagId
String
是
24位字符
ACB0B7302D6C7CD7010A****
超高频芯片的UID,为24位十六进制字符。
secureCode
String
是
8位字符
1809****
阿里云发行的安全码,为8位十六进制数。
输入参数示例
{ "customerId": "143496402717****", "serviceId": "123456****", "tagId": "ACB0B7302D6C7CD7010A****", "secureCode": "1809****" }
返回参数示例
{ "code": "00", "msg": "success", "data": { "tagId": "ACB0B7302D6C7CD7010A****", "secureCode": "1809****" }, "success": true, "failed": false }