feat: add scoped cookie operations for support

This commit is contained in:
yml2213
2026-08-13 16:17:06 +08:00
parent cf3fe68de3
commit 47ded2bc3e
15 changed files with 806 additions and 14 deletions
+7
View File
@@ -0,0 +1,7 @@
店铺IDA20260813141939
默认账号
B178660196602145988
默认密码
afac3645
AppKey: 2AJjbWmZ28cu723Q
AppSecret: 5SDFbYEMgDITOKYzDUhBOQAPyTYBQ4UK
+106
View File
@@ -0,0 +1,106 @@
# 接口规范
# 一、请求格式
# 二、AppId、AppKey 和 AppSercet
- 由双方协定,或由我平台提供
- AppId:商户号
- AppKey:长度为16位
- AppSecret:长度为32位
- 用于
- 卡券、卡密类订单的数据的加密
- 签名时的补充数据
- *AppSercet需考虑定期更换*
# 三、请求接口公共参数
***可选参数在对接时,请联系对接方,非特殊说明情况下,默认不传递***
# 四、请求签名规则
**注意:签名前,需双方协定或由厂商提供AppSecret**
sign签名时
1. 去掉空格:剔除参数名和参数值的前后空格,包括\\n和\\r等空值
2. 剔除空值:如果参数没有值,不参与签名
3. **sign不参与签名,其他字段均参与签名**
4. 排序生成待签名串:
1. 所有参数名**按照ascii顺序**进行排序
2. 并且参数名与参数值**通过a=1\&b=2的方式**将所有参数进行组合
3. 生成新的字符串后在字符串后**加上请求的方式**
4. 再**加上AppSecret**后获得待签名字符串
5. 进行加密
1. 默认进行MD5加密
2. 将第三步的待签名字符串进行utf8编码
3. 再进行md5操作后得到字符串
4. 最后转小写后为签名字符串
```JSON
// 假定 AppSercet 为 ac9fa79db418fd2c61d9bd4c60956f2d5db3a6d781d6f91f2e96327c74dfaccd
// 假定是下订单的接口 POST
// 待签名参数
{
// 公共参数
app_id: '15945681 ',
timestamp: 1740916504,
// 业务参数
charge_account: '18888888888',
buy_num: 2,
customer_price: 1.21,
customer_order_no: 'DD202507010010208888',
product_id: '66668888'
}
// 上述参数的签名字符串(去掉空值、去掉空格;最后加上请求方法和AppSecret)
app_id=15945681&buy_num=2&charge_account=18888888888&
customer_order_no=DD202507010010208888&customer_price=1.21&
product_id=66668888&timestamp=1740916504
POSTac9fa79db418fd2c61d9bd4c60956f2d5db3a6d781d6f91f2e96327c74dfaccd
// MD5后转小写,签名字符串为:
4087a959f3488ecb13efe6ef58e3bc67
```
# 五、响应公共信息
**响应签名规则请参考“请求签名规则”**
**sign不参与签名,其他字段均参与签名**
@@ -0,0 +1,76 @@
# 创建订单【必要】
# 接口说明
- 下单接口
- POST 请求
- application/json
- 接口地址 ***adapter\-apiaccess/open/api/createOrderV2***
# 请求参数
**notify\_url**
- 一些直充类的订单时间比较久,但不能持续占用连接
- 不传就不回调,订单的状态在查询时处理
**recharge\_arg**:(此处数据为用户填写和对应模板)
```Plain Text
[
{
"templateName": "模板名,一般是中文,如手机号,只是标识用,调用方可自行决定",
"templateVal": "用户填写的充值账号,比如:19876543210",
}
]
```
这里是用户填写的信息,比如:充值手机号:19876543210
templateName:充值手机号
templateVal19876543210
**ext\_arg**:(此处数据均为双方约定)
```Plain Text
{
"skuid": 243241231238888888,
"skuname: "电商平台的商品名称"
}
```
# 响应信息
## code数据对业务流程的影响
- 如果返回 200 的状态码,则下单成功,后续通过【查询订单】或者【订单异步通知】来获取订单结果状态
- 如果返回非 200 的状态码,订单失败,流程结束
## order\_status数据对业务流程的影响
- 0,待处理;1,处理中;2,成功;3,失败; 4,异常
- 当为 0 和 1 时,订单没有结束,
- 需要调用方自轮询查询订单;
- 或本平台订单结束后,异步通知订单结果
@@ -0,0 +1,54 @@
# 查询订单【必要】
# 接口说明
- 订单查询接口
- GET 请求
- application/x\-www\-form\-urlencoded
- 接口地址 ***adapter\-apiaccess/open/api/queryOrderV2***
# 请求参数
# 响应信息
## code数据对业务流程的影响
- 查询订单时如果返回非 200 的状态码,订单失败,流程结束
## order\_status数据对业务流程的影响
- 当为 0 和 1 时,订单没有结束,
- 需要调用方自轮询查询订单;
- 或本平台订单结束后,异步通知订单结果
- 当为 2 和 3 、4 时,订单结束
## cards解密后的结构如下
```JSON
[
{
card_no: 'CN88889999',""
card_pwd: 'ABCD-DEFG-GHIJ-JKLM',
expired_time: '2026-09-27 08:36:58',
price: '8.8',
card_type: '0'00. 1.
}
]
```
@@ -0,0 +1,34 @@
# 订单异步通知【推荐】
# 接口说明
- 下单后,如订单流程、时间较长,需要第一时间返回下单成功状态,之后的流程中再去通知外部平台订单的状态
- POST 请求
- 接口地址一般为 ***http://IP******\[:PORT\]/网关/业务/callBackV2***
- 具体地址,请双方开发协定,或联系运营获取
# 请求参数
## cards解密后的结构如下:
```JSON
[
{
card_no: 'CN88889999',""
card_pwd: 'ABCD-DEFG-GHIJ-JKLM',
expired_time: '2026-09-27 08:36:58',
price: '8.8',
card_type: '0'00. 1.
}
]
```
# 响应信息
@@ -0,0 +1,20 @@
# 账户信息查询
# 接口说明
- 下单接口
- GET 请求
- 接口地址 ***adapter\-apiaccess/open/api/userInfoV2***
# 请求参数
# 响应信息
@@ -0,0 +1,20 @@
# 账户信息查询
# 接口说明
- 下单接口
- GET 请求
- 接口地址 ***adapter\-apiaccess/open/api/userInfoV2***
# 请求参数
# 响应信息