接口文档

Appearance

有问题？搜索试试,大部分问题都有解🔍

修改设备号 ​

  • 修改设备号后 设备档案id 不变
  • 支持同时修改采集器号和表号
  • 支持只修改表号

接口地址 ​

地址：/Api_v2/ele_meter/renew

接口参数 ​

字段名变量名必填类型描述
授权码auth_code✔️String(32)系统为使用区域分配的授权码，在后台配置页面获取
时间戳timestamp✔️String(10)自1970年1月1日（08:00:00 GMT）至当前时间的总秒数
请求内容request_content✔️String传入采集器号列表添加指定的采集器
签名sign✔️String(32)通过签名算法计算得出的签名值，详见签名生成算法

request_content字段说明 ​

字段名变量名必填类型描述
旧采集器号old_cid✔️String采集器号
新采集器号new_cid✔️String采集器号
旧表号old_address✔️String表号
新表号new_address✔️String表号
备注description✔️String备注
请求内容示例
json
{
  "auth_code": "37577f8fb62a7b14ba55cc6faec5a142",
  "timestamp": "1586740681",
  "request_content": [
    // 示例1：同时修改采集器号和表号
    {"old_cid": "12345678901", "new_cid": "12345678902", "old_address": "000066660942", "new_address": "000066660943", "description": "更新采集器和表号"},
    // 示例2：只修改表号
    {"old_cid": "12345678901", "new_cid": "12345678901", "old_address": "000066660942", "new_address": "000066660950", "description": "只修改表号"},
  ],
  "sign": "fee536cf6a37a200d6761df04f5bf368"
}

返回结果 ​

Details
字段名变量名必填类型示例值描述
返回状态码status✔️StringSUCCESSSUCCESS/FAIL，此字段是通信标识
时间戳timestamp✔️String(10)1586744791自1970年1月1日（08:00:00 GMT）至当前时间的总秒数
回复内容response_content✔️String见下方说明详见response_content字段说明
签名sign✔️String(32)d0442d8cd04d85221bc940e7a5a12c35通过签名算法计算得出的签名值，详见签名生成算法
出错原因error_msg❌String授权码错误当返回状态码为"FAIL"时，返回信息为错误原因

TIP

response_content 返回的是一个 JSON 数组，每个元素代表一个采集器的添加结果。例如：

json
[
  {
    "status": "SUCCESS",
    "old_cid": "12345678901", "new_cid": "12345678901", 
    "old_address": "000066660942", "new_address": "000066660950",
    "description": "只修改表号",
  },
]

接口测试工具 ​