接口文档

Appearance

设置电表参数接口文档 ​

注意

注意 ​

接口地址 ​

URL地址: http://api2.tqdianbiao.com/Api_v2/ele_write

接口参数 ​

公共参数
字段名变量名必填类型描述
授权码auth_code是String(32)系统为使用区域分配的授权码，在后台配置页面获取
时间戳timestamp是String(10)自1970年1月1日（08:00:00 GMT）至当前时间的总秒数
请求内容request_content是String详见request_content字段说明，注意 request_content 是json数组，注意合并请求⭐
回调地址notify_url是String系统处理完查询请求后，通过这个回调地址，把数据推送给请求方
签名sign是String(32)通过签名算法计算得出的签名值，详见签名生成算法

请求内容request_content字段说明 ​

字段名变量名必填类型描述
操作IDopr_id是String操作ID，长度16-32，请求时自己生成，用于标识一次异步操作任务，须保证唯一性
采集器号cid是String采集器号,4G、NB设备采集器号与表号一致
表号address是String表号（表地址）
超时时间time_out否int超时时间 单位秒，任务因通讯异常等情况未执行自动失效的时间 ,默认1年
是否必须在线must_online否Boolean如果传true ,则系统接受任务时设备不在线直接返回失败 ，默认 false
重试次数retry_times否int重试次数（0-3） ,默认1次
操作类型type是int操作类型ID
设置数据params是json String设置的参数值json String，操作需要一个值，则设置key为p1，需要两个值得操作，key为p1，p2，以此类推

同步返回结果 ​

字段名变量名必填类型描述
返回状态码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"时，返回信息为错误原因

同步回复内容response_content字段说明 ​

字段名变量名必填类型描述
操作IDopr_id是String操作ID，长度16-32，请求时自己生成，用于标识一次异步操作任务，须保证唯一性
采集器号cid是String采集器号,4G、NB设备采集器号与表号一致
表号address是String表号（表地址）
查询状态status是String查询请求结果状态，说明提交的任务成功或者失败
错误信息error_msg否String当查询状态：status值不为“SUCCESS”时，填入具体的出错内容

异步返回结果 ​

字段名变量名必填类型描述
时间戳timestamp是String(10)自1970年1月1日（08:00:00 GMT）至当前时间的总秒数
回复内容response_content是String处理结果数据，查询类型不同，包含数据也会有所差异。
签名sign是String(32)通过签名算法计算得出的签名值，详见签名生成算法

请求示例 JSON ​

json
{
  "auth_code": "37577f8fb62a7b14ba55cc6faec5a142",
  "timestamp": "1586740681",
  "request_content": [
    {
      "opr_id": "d8c5055e10e845d59f2c11153d3d33d2",
      "time_out": 0,
      "must_online": true,
      "retry_times": 1,
      "cid": "19020618114",
      "address": "000066660942",
      "params": {
        "p1": 200
      },
      "type": 24
    }
  ],
  "notify_url": "http://115.221.11.179:8022/notify",
  "sign": "fee536cf6a37a200d6761df04f5bf368"
}

参数示例 ​

注意

设置负荷限制功率参数示例
json
...
    "params": {
      "p1": 10,
    },
    "type": 122
键描述
p1负荷限制功率 0-99.9999kw 默认 10kw
设置费率电价参数示例
json
...
    "params": {
      "p1": 1,
      "p2": 2,
      "p3": 3,
      "p4": 4,
    },
    "type": 12
键描述
p1尖电价
p2峰电价
p3平电价
p4谷电价
阶梯电价参数示例
json
...
      "params": {
        "p1": 1,
        "p2": 2,
        "p3": 3,
        "p4": 4,
        "p5": 5,
        "p6": 6,
        "p7": 7,
        "p8": 8,
        "d1": "121100",
        "d2": "121101",
        "d3": "121102",
        "d4": "121103",
      },
      "type": 13
键描述单位
p1第一阶梯差价元/KWh
p2第二阶梯差价元/KWh
p3第三阶梯差价元/KWh
p4第四阶梯差价元/KWh
p5第一阶梯值KWh
p6第二阶梯值KWh
p7第三阶梯值KWh
p8第四阶梯值KWh
d1第一结算日日期 格式 MMddHH
d2第二结算日日期 格式 MMddHH
d3第三结算日日期 格式 MMddHH
d4第四结算日日期 格式 MMddHH
设置时区
json
...
    "params": {
      "p1": "020101",
      "p2": "060202",
      "p3": "080303",
      "p4": "120404",
    },
    "type": 126
键描述
p12月1日 使用第一时段表
p26月2日 使用第二时段表
p38月3日 使用第三时段表
p412月4日 使用第四时段表
设置时段
json
    ...
    "params": {
      "p1": "020101",
      "p2": "060202",
      "p3": "080303",
      "p4": "120404",
      "p5": "140505",
      "p6": "160504",
    },
    "type": 129
键描述
p12时1分 尖时段
p26时2分 峰时段
p38时3分 平时段
p412时4分 谷时段
p514时5分 深谷时段（部分表支持）咨询商务对接人员
p616时5分 谷时段

设置类型值/ type 字段值 ​

操作类型ID描述
12设置费率电价
13设置阶梯电价
126设置时区
129设置日时段表1
130设置日时段表2
185设置日时段表3 （部份表支持）咨询商务对接人员
186设置日时段表4 （部份表支持）咨询商务对接人员
23设置电流互感器变比
122负荷限制功率

接口测试工具 ​