接入流程说明
您按照接口文档提供对应的增删改以及分配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}