全部产品

安全RFID标签-超高频读写器

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

数据交互说明

  • 1. 超高频RFID只能与特殊的超高频读写设备交互,无法通过手机识别。

  • 2. 阿里云提供服务端接口,由超高频读写器厂商进行集成和适配,已完成适配的读写器型号会陆续更新。

  • 3. 提供四个能力:

    • 发行安全EPC

    • 认证安全EPC

    • 发行安全标识码

    • 认证安全标识码

设备端接口

无(由读写器设备商自行集成)

服务端接口

1)发行安全EPC

  • 接口形式:Restful

  • 入口地址:https://iotx-trusted-tag-vpc-sh.iot.aliyun.com

  • 接口地址:/uhf/1/issue/96epc

  • 功能描述:发行阿里云标准96bit 超高频RFID安全EPC,用于写入芯片的EPC区域

  • 请求方式:POST

  • 参数格式:application/json

  • 参数说明:

名称

类型

是否必选

取值要求

示例值

描述

customerId

String

16位字符

"1434964027179725"

阿里云账号UID

serviceId

String

10位字符

"1234567890"

IoT安全中心创建的项目serviceId

tagId

String

24位字符

"D854A8559F7046D4BEF0432D"

超高频RFID的唯一ID(96bit),为24位十六进制字符

  • 输入参数示例

{
    "customerId": "1114975502172915",
    "serviceId": "9623656710",
    "tagId": "E280B11C211078010815E297",
}

  • 返回参数示例

{
    "code": "00",        //结果码, "00"表示成功,其他值参照错误码表
    "msg": "success",    //结果消息
    "data": {            // 当code为"00"时,data对象不为空
        "encSessionKeyBase64": "vwm/hoaQ4ZaNCdr9fCdwWL2xHI0TUOkdgc2upi4vSBfO52dE8RBxy9J+rFVpsMIVdlSpd2w70dIVRinaet+V8OXIThTGkd1/ezr0D4FO2MPgVVNp1gAj0FzpYoRsuR/8ose88brzyy15pLcf41P6/jXIQaLGqG0TOn1LnYArJWU=",    //被公钥经RSA1024算法加密后的session key
        "encDataBase64": "vCCaehK8kfopfKNARxe46z2zxWzBbYEWunHlr5Hswnm2cXHeU7lm7ckcn9zOT6Gq3yOlDLZWcuXE2kyGydnkfJiLPxcKZUvZrTS2llwwq4M4IE6UuZa/jQsCZWsr7pHja3qoGWgOJIzdLngps3XrvA=="     //被session key经AES128算法加密后的EPC值
    },
    "failed": false,
    "success": true
}

2)认证安全EPC

  • 接口形式:Restful

  • 入口地址:https://iotx-trusted-tag-vpc-sh.iot.aliyun.com

  • 接口地址:/uhf/1/auth/96epc

  • 功能描述:对阿里云发行的标准96bit 超高频RFID安全EPC进行认证

  • 请求方式:POST

  • 参数格式:application/json

  • 参数说明:

名称

类型

是否必选

取值要求

示例值

描述

customerId

String

16位字符

"1434964027179725"

阿里云账号UID

serviceId

String

10位字符

"1234567890"

IoT安全中心创建的项目serviceId

tagId

String

24位字符

"ACB0B7302D6C7CD7010A9BAE"

超高频芯片的UID,为24位十六进制字符

epc

String

24位字符

"A58C0BE6D3234386A8B9C76D"

阿里云发行的安全EPC,为24位十六进制数

  • 输入参数示例

{
    "customerId": "1114975502172915",
    "serviceId": "9623656710",
    "tagId": "E280B11C211078010815E297",
    "epc": "1809EC8C211078010815E297",
}

  • 返回参数示例

{
    "code": "00",         //结果码, "00"表示成功,其他值参照错误码表
    "msg": "success",       //结果消息
    "data": {               // 当code为"00"时,data对象不为空
        "tagId": "E280B11C211078010815E297",  // 与请求参数中的tagId一致
        "epc": "1809EC8C211078010815E297"     // 与请求参数中的epc一致
    },
    "failed": false,
    "success": true
}

3)发行安全标识码

  • 接口形式:Restful

  • 入口地址:https://iotx-trusted-tag-vpc-sh.iot.aliyun.com

  • 接口地址:/uhf/1/issue/32sc

  • 功能描述:发行阿里云超高频RFID安全码,用于写入RFID芯片的user区域

  • 请求方式:POST

  • 参数格式:application/json

  • 参数说明:

名称

类型

是否必选

取值要求

示例值

描述

customerId

String

16位字符

"1434964027179725"

阿里云账号UID

serviceId

String

10位字符

"1234567890"

IoT安全中心创建的项目serviceId

tagId

String

24位字符

"ACB0B7302D6C7CD7010A9BAE"

超高频芯片的UID,为24位十六进制字符

  • 输入参数示例

{
    "customerId": "1114975502172915",
    "serviceId": "9623656710",
    "tagId": "E280B11C211078010815E297",
}

  • 返回参数示例

{
    "code": "00",        //结果码, "00"表示成功,其他值参照错误码表
    "msg": "success",      //结果消息
    "data": {          // 当code为"00"时,data对象不为空
        "encSessionKeyBase64": "n52HM55wHJ97fz2I9iLUkFa9Cbf30lGClMOG/aw2Z+FUdDyBOtGLc47Ar+iGFn4wYlqX1k0MzK7BB80Tj61SB/PCcjjsFriM4qIKR4NNZqVnyL+IM3vNMcKhddFRILM5lrdNADtRPWpntupfZT+xNUIhjH5n0/V25YGY4hHyeFg=",    //被公钥经RSA1024算法加密后的session key
        "encDataBase64": "nLsZoR6GdjPmUw0vpzFhBTX+d8w71K3BDsgPgUFsuTcuO0e3PFdeLZ2ZRmPsOMRm88Cth1cNQi0u23TsC4lh19VQK89uo8ZzFWDhxrE6j7O8mvEy9Tw8uN0MsOm2ERZuTGEJrfcuq+ZQXr8TAQfxgQ=="   //被session key经AES128算法加密后的secure code
    },
    "success": true,
    "failed": false
}

4)认证标识

接口形式:Restful

  • 入口地址:

    https://iotx-trusted-tag-vpc-sh.iot.aliyun.com

  • 接口地址:/uhf/1/auth/32sc

  • 功能描述:对阿里云发行的标准超高频RFID安全码进行认证

  • 请求方式:POST

  • 参数格式:application/json

  • 参数说明:

名称

类型

是否必选

取值要求

示例值

描述

customerId

String

16位字符

"1434964027179725"

阿里云账号UID

serviceId

String

10位字符

"1234567890"

IoT安全中心创建的项目serviceId

tagId

String

24位字符

"ACB0B7302D6C7CD7010A9BAE"

超高频芯片的UID,为24位十六进制字符

secureCode

String

8位字符

"1809EC8C"

阿里云发行的安全码,为8位十六进制数

  • 输入参数示例

{
    "customerId": "1114975502172915",
    "serviceId": "9623656710",
    "tagId": "E280B11C211078010815E297",
    "secureCode": "1809EC8C"    
}
  • 返回参数示例

{
    "code": "00",
    "msg": "success",
    "data": {
        "tagId": "E280B11C211078010815E297",
        "secureCode": "1809EC8C"
    },
    "success": true,
    "failed": false
}