文档

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

更新时间:

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

背景信息

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

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

  • 发行安全EPC

  • 认证安全EPC

  • 发行安全标识码

  • 认证安全标识码

超高频读写器开发

设备端接口

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

服务端接口

  1. 发行安全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
      }
  2. 认证安全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
      }
  3. 发行安全标识码

    • 接口形式: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
      }
  4. 认证标识

    • 接口形式: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
      }