[开发测试]国网电费优惠api接口文档源码后台

国网电费优惠api接口文档源码后台，

golang系统开发的平台，集合15家全国电费接口供应商，满足你的技术要求。

国网电费优惠充值的平台，是2021年下半年开始出来的一个新鲜的技术，市面上有很多的供应商，但是呢，做API接口的这样的一个平台却很少，只有那么寥寥的几个。

?各种各样的接口，满目琳琅，让我们不知道怎么去分辨，花尽心思对接了一个之后呢？发现不稳定也浪费了自己的时间，我们怎么找到一个稳定的国网电费API接口充值的这样的一个渠道呢？

我看了市场上对比了15家供货商的接口之后呢，我把他们全部集中到了我自己开发的一个系统的后台。嗯，接下来，我会把我后台的API接口文档发给大家，分享一部分给大家对接。嗯，具体测试的话可以插个眼，我等下发进来。

国网南网电费优惠充值对接文档 V1.0

商品对接文档 V1.01. 前言2. 通用下单接口2.1 签名生成2.2 扩展参数2.2.1 话费2.2.2 电费2.3 充值示例2.2.1 示例程序（python3）2.3 成功响应示例2.3 失败响应示例2.4 回调通知示例(POST JSON)2.4.1 签名3. 订单查询3.1 成功响应示例4. 余额查询4.1 成功响应示例5.状态码对照表

1. 前言

接口遵循RESTFul规范，所有请求 / 响应，均使用JSON格式，成功均返回 2XX HTTP状态码，失败均返回 4XX / 5XX HTTP状态码。

接口返回统一数据格式，其中code为0表示成功 data 内为返回数据对象

{

 ? ?"code": 0,

 ? ?"msg": "成功",

 ? ?"data": {}

}

请求接口时，接口数据进行加密使用如下字段：

uid: 商户UID

key: 数据加密key

以上字段可在 后台 -> API -> API秘钥 中查看。

为了避免不必要的沟通，请求接口仅支持 POST json 形式请求，请严格使用post json 格式进行提交

time_stamp 时间戳，当前接口生成的加密时间不能超过5分钟

请求使用的API域名 https://api.jxkj007.com/

文档最后更新时间：2021年12月20日。

2. 通用下单接口

地址：/connector/order/commit

方法：POST

商品commodity_id 和 goods_id可从后台查看您目前可用的商品

2.1 签名生成

签名生成采用传统的MD5方式，进行自定义接口数据拼接

将参数按照key排序拼接 key^value== 后面拼接数据加密key

• 例

call_back_url^http://127.0.0.1:8003/callback==changer_price^10000==commodity_id^2==expand^{"province": "\u5e7f\u5dde", "card_type": "\u4e2d\u56fd\u8054\u901a"}==number_no^18888888888==order_id^a692d25c619d11ec9950acde48001122==time_stamp^1640009027==uid^2==E065C385715CEB45CB096A91800BAE17

• 字段中间以 == 进行拼接 字段与字段值间使用^ 拼接

  拼接完成之后的值进行MD5 小写运算生成 sign

2.2 扩展参数

2.2.1 话费

话费可不填扩展参数，也可以不传，并可以根据金额自动匹配商品goods_id 也就是说不用传goods_id

2.2.2 电费

电费必填

2.3 充值示例

话费快充示例 使用的KEY为 E065C385715CEB45CB096A91800BAE17

 'time_stamp': 1640010407, 

 'uid': 2, 

 'commodity_id': 2, 

 'changer_price': 10000,

 'number_no': '18888888888',

 'goods_id': 2, 

 'order_id': 'dd2722de-61a0-11ec-aa57-acde48001122', 

 'call_back_url': 'http://127.0.0.1:8003/callback', 

 'expand': '{"province": "\\u4e0a\\u6d77", "card_type": "\\u4e2d\\u56fd\\u8054\\u901a"}', 

 'sign': '1839b1e8987a5a58ddc67c4e126937fe'

}

4. 余额查询

地址：/connector/order/account

方法：POST

4.1 成功响应示例

{

 ? ?"code": 0,

 ? ?"msg": "成功",

 ? ?"data": {

 ? ? ? ?"balance": 9031580,

 ? ? ? ?"name": "xxxx",

 ?  }

}

5.状态码对照表