接口描述

根据设备id查询麻雀云节点id

请求路径

POST /v1/ant/mapping

请求参数

名称	类型	位置	必须	描述
Authorization	string	header	是	鉴权 token
Content-Type	string	header	是	数据类型 application/json
vendorDeviceIds	[]string	body	是	设备ID列表

返回值

名称	类型	描述
mappings	[]VendorIdMapNodeId	设备ID与节点ID映射列表

VendorIdMapNodeId

名称	类型	描述
vendorDeviceId	string	设备ID
nodeIds	[]string	节点ID(若映射到了多个节点ID, 默认按最近活跃排序)

请求示例

{
  "VendorDeviceIds": [
    "ID1",
    "ID2",
    "ID3"
  ]
}

返回值示例

• ID1上机过多次, 最近一次上机对应节点ID为ante5994b49045028f4404b58ef97985
• ID2上机过一次
• ID3没上过机

正常请求:
  http code 200
{
  "mappings": [
    {
      "vendorDeviceId": "ID1",
      "nodeIds": [
        "ante5994b49045028f4404b58ef97985",
        "anteb52eecc913ed0c3608ae4c43f399"
      ]
    },
    {
      "vendorDeviceId": "ID2",
      "nodeIds": [
        "ant2e3a6bad9238738cc9077bf101983"
      ]
    },
    {
      "vendorDeviceId": "ID3",
      "nodeIds": []
    }
  ]
}

异常请求:
  http code 4xx/5xx
{
  "code": 4000001,
  "desc": ""
}

错误码列表

错误码	描述
401	鉴权失败
4000001	参数错误, 传入的设备ID为空

如接口返回错误码未列举，可在错误码总览中查找