应用场景: 部分站点支持手持打印机,用户提供二维码打印停车小票。此接口用于返回二维码链接,二维码规则可由服务商自行定义。
注意:链接需要采用https协议。
接口名称: queryParkingTicketQrCode
接口流程
调用方式: POST
注意: 接口幂等性由服务商保证,即同笔订单号查询小票二维码信息返回的数据一致。
请求参数
参数名称 | 类型 | 备注 |
---|---|---|
data | String | 加密后的数据 |
timeStamp | number | 秒级时间戳 |
seq | String | 请求序列:接口每秒的请求递增计数,格式为yyyMMddhhmmss+四位递增计数 |
token | String | 凭证:32位字符串,认证接口(queryToken)不需要此参数 |
sign | String | data+timeStamp组成的参数签名 |
data:
参数名称 | 类型 | 是否必填 | 备注 |
---|---|---|---|
orderId | String | Y | 服务商订单号 |
carNo | String | N | 车牌号 |
totalPower | number | Y | 充电电量 |
totalMoney | number | Y | 充电金额(实际支付金额),精确到2位小数,单位:元 |
timeStart | String | Y | 24小时制!充电开始时间yyyy-MM-dd HH:mm:ss |
timeEnd | String | Y | 24小时制!充电结束时间yyyy-MM-dd HH:mm:ss |
stationName | String | Y | 站点名称 |
示例
{
"data": {
"orderId": "330233",
"carNo": "浙Axxxx",
"totalPower": 11.28,
"totalMoney": 12.28,
"timeStart": "2020-08-11 12:06:54",
"timeEnd": "2020-08-11 15:06:54",
"stationName": "杭州市滨江区国网充电站"
},
"timeStamp": 1505374350,
"seq": "201709141214150001",
"token": "94b879e509a8e20821c7587aad53c19f",
"sign": "8D5AD1A57D30956CC946CFFDFCFD4AE3"
}
响应参数
子类 | 返回参数名 | 类型 | 是否必填 | 备注 |
---|---|---|---|---|
code | int | 必填 | 整数类型,成功: 100 失败: 400,更多状态描述请看第6章:状态描述 | |
data | 桩群编号 | |||
orderId | String | 必填 | 服务商订单号 | |
qrCode | String | 必填 | 二维码链接 | |
expireTime | int | 必填 | 二维码有效时间,单位秒。-1为永不失效。 | |
msg | String | 非必填 | 失败时返回具体原因 |
成功
{
"code": 100,
"data": {
"orderId": "148878924804013004013",
"qrCode": "https://xxxx”,
"expireTime": 600
},
"msg":"success"
}
失败
{
"code": 100,
"data": {
"orderId": "148878924804013004013"
},
"msg":"此站点不支持打印"
}