如何调用安全RFID标签API实现超高频读写器-阿里云帮助中心

适用于超高频芯片的通用接口，不局限于某款芯片。

背景信息

超高频RFID只能与特殊的超高频读写设备交互，无法通过手机识别。由阿里云提供服务端接口，超高频读写器厂商进行集成和适配，已完成适配的读写器型号会陆续更新。

目前超高频RFID提供了四个能力：

发行安全EPC
认证安全EPC
发行安全标识码
认证安全标识码

超高频读写器开发

设备端接口

由读写器设备商自行集成。

服务端接口

发行安全EPC

接口形式：Restful。
入口地址：https://iotx-trusted-tag-vpc-sh.iot.aliyun.c。
接口地址：/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
入口地址：https://iotx-trusted-tag-vpc-sh.iot.aliyun.com
接口地址：/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
入口地址：https://iotx-trusted-tag-vpc-sh.iot.aliyun.com
接口地址：/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
入口地址：https://iotx-trusted-tag-vpc-sh.iot.aliyun.com
接口地址：/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
}