接口文档

Appearance

电能表添加 ​

接口链接 ​

URL地址：http://api2.tqdianbiao.com/Api_v2/ele_meter/add

接口参数 ​

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

request_content 字段说明 ​

字段名变量名类型描述
采集器号cidstring设备的唯一标识符，用于区分不同的采集器。通常为数字字符串。
表号addressstring电表的唯一地址，用于识别特定的表设备。通常为数字字符串。
表类型modelstring表的类型，表示水表的具体型号或类别。通常为字符串。 获取表类型
备注descriptionstring电表的备注信息，通常用于描述电表的位置或用途。

TIP

请求示例 ​

json
{
  "auth_code": "37577f8fb62a7b14ba55cc6faec5a142",
  "timestamp": "1586740681",
  "request_content": [
    {"cid": "19020618114", "address": "000066660942", "model": "154", "description": "电表1"},
    {"cid": "19020618114", "address": "0000666609", "model": "154", "description": "电表2"},
    {"cid": "1902061811", "address": "000066660942", "model": "154", "description": "电表3"},
    {"cid": "12345678901", "address": "000066660942", "model": "154", "description": "电表4"},
    {"cid": "12345678901", "address": "000066660942", "model": "154"},
    {"cid": "11335577990", "address": "000066660942", "model": "154"}
  ],
  "sign": "fee536cf6a37a200d6761df04f5bf368"
}

返回结果 ​

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

返回示例 ​

json
{
  "status": "SUCCESS",
  "timestamp": "1586744791",
  "response_content": [
    {"model":"154","status":"SUCCESS","cid":"19020618114","address":"000066660942"},
    {"status":"FAIL","error_msg":"只支持12/14位表号","cid":"19020618114","address":"0000666609"},
    {"status":"FAIL","error_msg":"只支持11/12位采集器号","cid":"1902061811","address":"000066660942"},
    {"status":"FAIL","error_msg":"采集器未注册","cid":"12345678901","address":"000066660942"},
    {"status":"FAIL","error_msg":"采集器未注册","cid":"11335577990","address":"000066660942"}
  ],
  "sign": "d0442d8cd04d85221bc940e7a5a12c35",
  "error_msg": "授权码错误"
}

回复内容response_content字段说明 ​

字段名变量名必填类型描述
采集器号cid是String(12)采集器号,4G、NB设备采集器号与表号一致
电表地址address是String(12)电能表表地址
电表型号model否String电表型号，添加电表的时候指定；如果没有指定，默认为系统后台配置的默认电表类型，如何查看电表类型对应的model值？
添加状态status是String电表添加结果状态码，"SUCCESS"， "FAIL"
错误原因error_msg否String电表添加状态码不是"SUCCESS"时，返回信息为错误原因，如"只支持12/14位表号"，"只支持11/12位采集器号"，"采集器未注册"等

接口测试工具 ​