铁塔充电数据推送接口文档
    铁塔充电数据推送接口文档
    • 接入流程说明
    • 铁塔两轮充电数据推送接口文档
      • 充电站址信息推送
        • 新增充电站址
        • 修改充电站址
        • 根据id删除站址信息
      • 充电站信息推送
        • 新增充电站
        • 修改充电站
        • 根据id删除充电站信息
      • 充电端口信息推送
        • 新增充电口
        • 修改充电口
        • 删除充电口
      • 充电记录信息推送
        • 新增一条充电记录
      • 获取token接口
        • 获取token接口
      • 设备实时属性
        • 设备属性同步(遥测)
      • 设备告警推送
        • 告警推送

    接入流程说明

    一 整体对接思路:
    您按照接口文档提供对应的增删改以及分配token的接口.我们这边会根据我们系统用户的行为来实时调用您所提供的这些接口,以将数据保存到您自己的数据库中.最终目的是两边数据同步,您自己系统中的前端页面从您的数据库中获取数据.
    具体步骤
    1:您需要向平台申请获取到OperatorId和Signature(相当于秘钥).
    2:您需提供一个获取token的接口,我们会携带秘钥及当前时间来请求接口获取token.
    3:您需提供您那边的请求域名(即我们调用您服务器接口时的前缀)
    4:您需要提供如下:接口
    1:获取token的接口.
    接口路径为: /merchants/integrate/v1/management/operatorAPIToken (GET请求)
    此接口的返回值必须为如下格式,token可以永久有效,也可以限时有效(注:限时有效,则时长必须大于5小时,每次调用需要刷新token有效期).我们建议token永久有效.
    {
        "status": 200,
        "message": "请求成功!",
        "data": "this is your provide token"
    }
    2:业务接口
    a.充电站管理 增删改接口
    接口路径为: /merchants/integrate/v1/management/site (新增:POST请求 修改:UPDATE请求 删除:DELETE请求)
    b.充电设施管理 增删改接口
    接口路径为: /merchants/integrate/v1/management/station (新增:POST请求 修改:UPDATE请求 删除:DELETE请求)
    c.充电口管理 增删改接口
    接口路径为: /merchants/integrate/v1/management/cell (新增:POST请求 修改:UPDATE请求 删除:DELETE请求)
    d.充电记录管理 新增接口
    接口路径为: /merchants/integrate/v1/management/chargingRecord (POST请求)
    二 注意事项:
    1.您所需要提供的接口需要符合restful风格,
    2.所有增删改的接口返回格式必须如下
    {"status":200,"message":"***操作成功","data":null}
    或
    {"status":500,"message":"***操作失败","data":null}
    3.附件中的java文件为其他厂商编写的实体类,供您参考.当然,您也可以直接视情况复用.注意字段类型需要一致.
    4.您写的充电站,充电设施,充电口的新增接口中,需要加入以下逻辑:如果对应的id在您的数据库中已经存在,则忽略此条数据.
    下一页
    新增充电站址
    Built with