账单单推送已完成

实时推送

测试地址：

{url}/dev-api/customer/busserial/onlinePush

生产地址：

{url}/api/customer/busserial/onlinePush

HTTP Method：POST
Content-Type：application/json

具体请求

header:
参数名 类型 是否必填 说明 示例
C-Date String 是 实时时间，datetime获取即可 1分钟内有效
Content-Type String 是 支持 application/json 与 multipart/form-data application/json;charset=utf-8 或
multipart/form-data
C-Secret String 是 输入秘钥中拿到的secretId
Sign String 是 签名

请求需要使用秘钥对来进行验证请求。

算法规则：https://www.yuque.com/hcses/shuichengtong/nh6o25#ZDNDe

算法SDK地址：https://gitee.com/hcwdc/Fortress-OpenApi-SDK

body:
  1. {
  2.     "memberId": "1503211080405483520",
  3.     "serialNo": "1505128577065025536",
  4.     "posCode": "pos7758",
  5.     "deviceScanTime": "2022-03-11 14:25:00",
  6.     "postTime": "2022-03-11 01:04:25",
  7.     "amount": "2",
  8.     "parkCardId": "1517437201502175233",
  9.     "codeHeader": "102"
  10. }

签名字符串：

  1. amount=2&cDate=2022-04-07 11:37:40&codeHeader=102&cSecretId=JV1yfM8QC2qOIg8QKCLiTJCLUIuh27MFB2tNOpnW&deviceScanTime=2022-03-11 14:25:00&memberId=1503211080405483520&parkCardId=1517437201502175233&posCode=pos7758&postTime=2022-03-11 01:04:25&serialNo=135167835070124

生成的签名：

  1. YTU0OWE3OWUzMjAyZDBkODY1MTQxMjM4MTEwMDc3YTY1ZmY2YzE5Nw==

请求参数说明

参数名 类型 是否必填 说明 示例
memberId String 是 用户名 1503211080405483520
serialNo String 是 流水号 1505128577065025536
posCode String 是 pos机器号
deviceScanTime String 是 扫码时间
postTime String 是 推送时间
amount String 是 消费金额
parkCardId String 是 景区套餐卡id | 网约公交券id 1517437201502175233
codeHeader String 是 码头 102

这里只是希望得到的数据，具体给返回的数据，对接的时候还需要继续增加

用户ID，流水号，设备扫码时间，消费金额，pos机器号

备选：线路、车号

响应参数

成功响应示例

  1. {
  2.     "msg": "操作成功",
  3.     "code": 200
  4. }

失败响应示例

  1. {
  2.     "msg": "签名验证失败",
  3.     "code": 500,
  4.     "remark": "详情访问网址查询问题：https://www.yuque.com/hcses/shuichengtong/uyyu98"
  5. }

响应参数说明

参数名 说明 备注
code 返回码 为200表示成功，非200表示调用失败，其他错误码请见返回码说明
data 返回数据
msg 返回码的文本描述内容

注意事项： 暂无

账单多条推送 已完成

支持一次传多条数据 离线推送

测试地址：

{url}/dev-api/customer/busserial/offlinePush

生产地址：

{url}/api/customer/busserial/offlinePush

HTTP Method：POST
Content-Type：application/json

具体请求

header:
参数名 类型 是否必填 说明 示例
C-Date String 是 实时时间，datetime获取即可 1分钟内有效
Content-Type String 是 支持 application/json 与 multipart/form-data application/json;charset=utf-8 或
multipart/form-data
C-Secret String 是 输入秘钥中拿到的secretId
Sign String 是 签名

请求需要使用秘钥对来就行验证请求。

算法规则：https://www.yuque.com/hcses/shuichengtong/nh6o25#ZDNDe

算法SDK地址：https://gitee.com/hcwdc/Fortress-OpenApi-SDK

body:
  1. {
  2.     "list" : [
  3.         {
  4.             "memberId" : "1503211080405483520",
  5.             "serialNo" : "123",
  6.             "deviceScanTime" : "2022-04-07 10:29:28",
  7.             "postTime" : "2022-04-07 10:29:28",
  8.             "amount" : "0.01",
  9.             "posCode" : "123"
  10.         },
  11.         {
  12.             "memberId" : "1503211080405483520",
  13.             "serialNo" : "123",
  14.             "deviceScanTime" : "2022-04-07 10:29:28",
  15.             "postTime" : "2022-04-07 10:29:28",
  16.             "amount" : "0.01",
  17.             "posCode" : "123"
  18.         }
  19.     ]
  20. }

签名字符串：

  1. cDate=2022-04-07 11:39:41&cSecretId=JV1yfM8QC2qOIg8QKCLiTJCLUIuh27MFB2tNOpnW&list=[{"amount":"0.01","serialNo":"135167835070124","deviceScanTime":"2022-03-11 14:25:00","postTime":"2022-03-11 14:25:00","posCode":"pos7758","memberId":"1503211080405483520"}, {"amount":"0.01","serialNo":"135167835070124","deviceScanTime":"2022-03-11 14:25:00","postTime":"2022-03-11 14:25:00","posCode":"123","memberId":"1503211080405483520"}]

生成的签名：

  1. Mjk3NzhjMmJkZjA5MWNmYzJhM2ZkZmEzNmUxMjJmYmQ4ZTZlZjhlYw==

请求参数说明

参数名 类型 是否必填 说明 示例
memberId String 是 用户名
serialNo String 是 流水号
posCode String 是 pos机器号
deviceScanTime String 是 扫码时间
postTime String 是 推送时间
amount String 是 消费金额

这里只是希望得到的数据

用户ID，流水号，设备扫码时间，消费金额，pos机器号

响应参数

成功响应示例

  1. {
  2.     "msg": "操作成功",
  3.     "code": 200
  4. }

失败响应示例

  1. {
  2.     "msg": "签名验证失败",
  3.     "code": 500,
  4.     "remark": "详情访问网址查询问题：https://www.yuque.com/hcses/shuichengtong/uyyu98"
  5. }

响应参数说明

参数名 说明 备注
code 返回码 为200表示成功，非200表示调用失败，其他错误码请见返回码说明
data 返回数据
msg 返回码的文本描述内容

注意事项： 暂无