# 接口文档
## 接口列表
| 名称 | 路径 | 请求方法 | Content-Type|字段|
| -------- | -------- | -------- | -------- | -------- |
| 插件列表 | /list | GET | / | / |
| 交互统一接口 | /core | POST | application/x-www-form-urlencoded | sign |
## 回调方式
*如回调时,httpcode != 200 则会每隔3s 总共3次 重新发起回调*
*body数据全部通过aes加密*
post -> callback
content-type -> application/x-www-form-urlencoded
body -> 解密后:```{"code":200,"msg":"","data":x}```
参数传递,通过在callback添加get参数进行确定
如请求ID:https://callback.com/c?request_id=123456
---
## 加密方式
交互统一接口只有一个外层结构,字段“sign”
如状态查询
```javascript
all_data = {
// 插件名称
"plugin-name": "gome-alipay-h5",
// 回调地址(如果值是一个正确的URL,则代表异步请求,建议同步请求,异步会多一个HTTP请求)
"callback":"",
// 调用的方法
"method":"state",
// 方法所需数据,如果是异步,请求创建成功 -> data = null
"data": {
"order_id":"1UC2NUC0305RQE8C",
"ots":"1672299493000",
"cookies":"",
"proxy":"127.0.0.1:1234"
}
}
```
```javascript!
// RSA加密上述JSON,可去除空格
sign_text = aes_encrypt(all_data)
// URL编码Sign 全编码模式 encodeURIComponent
sign = urlencode(sign_text)
```
---
### 插件 : gome-alipay-h5
#### method:keep
*Cookie保活*
*请求*
| 字段名 | 字段类型 |字段说明 |
| --- | --- | --- |
| cookies | string | Cookies列表 |
|proxy|string|代理IP 代理协议目前支持HTTP 格式:ip:端口 |
*响应*
code != 200 -> 保活失败
msg -> 失败原因
data != null -> 新的Cookie,需替换原有Cookie
#### method:state
*请求*
| 字段名 | 字段类型 |字段说明 |
| --- | --- | --- |
| order_id | string | 下单时返回的订单ID |
| cookies | string | Cookies列表 |
|proxy|string|代理IP 代理协议目前支持HTTP 格式:ip:端口 |
*响应*
| 字段名 | 字段类型 |字段说明 |
| --- | --- | --- |
| order_id | string | 订单ID |
| state | string | 'pending' = 等待付款,'paid' = 充值中,'canceled' = 已取消,'error' = 充值失败,'success' - 充值成功 |
```jsonld!
{
"code": 200,
"msg": "",
"data": {
"id": "1058889086460497920",
"pluginName": "gome-alipay-h5",
"addTime": "2022-12-31T23:27:11.420721",
"endTime": "2022-12-31T23:27:11.420743",
"amount": 100,
"state": "pending",
"payUrl": "https://mapi.alipay.com/gateway.do?_input_charset=utf-8&body=%E7%9C%9F%E5%BF%AB%E4%B9%90%E5%95%86%E5%93%81&it_b_pay=720m¬ify_url=http%3A%2F%2Fj.gpay.gome.com.cn%2Fcashierapi%2Fpay%2FALIPAYWAPVIRTON.dhtml&out_trade_no=10111800120441916966&partner=2088311598608551&payment_type=1&return_url=https%3A%2F%2Fwww.baidu.com&seller_email=gomefin002%40yolo24.com&seller_id=2088311598608551&service=alipay.wap.create.direct.pay.by.user&subject=%E7%9C%9F%E5%BF%AB%E4%B9%90%E5%95%86%E5%93%81-10111800120441916966&total_fee=100&sign=197379f6704aa457c3b78609c4a76c94&sign_type=MD5",
"pluginOrderId": "1UC2NUC0305RQEAR",
"pluginParameter1": "",
"pluginParameter2": "",
"requestId": "",
"callback": ""
}
}
```
#### method:place
*请求*
| 字段名 | 字段类型 |字段说明 |
| --- | --- | --- |
| phone | string | 充值的电话号码 |
| amount | string | 充值的金额 |
| cookies | string | Cookies列表 |
|proxy|string|代理IP 代理协议目前支持HTTP 格式:IP:端口 |
```jsonld!
{
"plugin-name":"gome-alipay-h5",
"method":"place",
"data":{
"phone":"13888888888",
"amount":"100",
"cookies":"uid=CmoFZGOn8r5Jx7eWEZ5iAg==; global_key=9dd85f913fa34e5f8f2b9f12d789d1c0; ssaa=4e80002e77b0498e88750d82cab22655; DYN_USER_ID=88157666966; gradeId=G1; sensorsdata2015jssdkcross=%7B%22distinct_id%22%3A%2288157666966%22%2C%22first_id%22%3A%22185480c379d781-0935ba781948b1-a3e3164-1764000-185480c379e16d7%22%2C%22props%22%3A%7B%22%24latest_traffic_source_type%22%3A%22%E7%9B%B4%E6%8E%A5%E6%B5%81%E9%87%8F%22%2C%22%24latest_search_keyword%22%3A%22%E6%9C%AA%E5%8F%96%E5%88%B0%E5%80%BC_%E7%9B%B4%E6%8E%A5%E6%89%93%E5%BC%80%22%2C%22%24latest_referrer%22%3A%22%22%7D%2C%22%24device_id%22%3A%22185480c379d781-0935ba781948b1-a3e3164-1764000-185480c379e16d7%22%7D; __uls=Y; __unick=gm_180%255E_%255E5563toul; gpid=11000000; gcid=11010000; gdid=11010200; gtid=110102002; organizationId=1001; gpName=%E5%8C%97%E4%BA%AC; gcName=%E5%8C%97%E4%BA%AC%E5%B8%82; gdName=%E6%9C%9D%E9%98%B3%E5%8C%BA; gtName=%E6%9C%9D%E5%A4%96%E8%A1%97%E9%81%93; addr_lng=116.44901575951573; addr_lat=39.92654605581156; awaken=true; cartnum=0_0-1_0; __ugk=; __uxglt=; ufpd=5ce4839a43995154038688c9407ba132e7265563af151e336e41262abe4d448e0c1134884b1d6531a9424d127a7754455bdd95b3db7378628c5b481914b2c03c|63a9bcb2zUGeBSNM0x7ASB4XIRsv4wShoxpUH431; SCN=NICD0w17dkH58GhwhqvvDsTS%2B4%2FV9g%2FgLXc%2BdlH3o9bOfY2%2FYpbHNz2Dwol1kABkMfN71Sft617D9sHSeZG%2FbUczh6Hv5E4wkR%2FT58zHi90ydZNYyh0wIw%3D%3D71d9eb158140669b326219f862e9ad0f; DYN_USER_CONFIRM=NICD0w17dkH58GhwhqvvDsTS%2B4%2FV9g%2FgLXc%2BdlH3o9bOfY2%2FYpbHNz2Dwol1kABkMfN71Sft617D9sHSeZG%2FbUczh6Hv5E4wkR%2FT58zHi90ydZNYyh0wIw%3D%3D71d9eb158140669b326219f862e9ad0f; SSO_USER_ID=88157666966; ctx=app-shangcheng|ver-v7.0.0|plt-wap|cmpid-; ads=0; http_referer=https%3A%2F%2Fprom.m.gome.com.cn%2Fgcms%2FMobsaleXeJZtP71hvW.html; JSESSIONID=DF8DA5FA2435DA8302AFFCD0C492B817",
"proxy":"127.0.0.1:10871"
}
}
```
*响应*
| 字段名 | 字段类型 |字段说明 |
| --- | --- | --- |
| phone | string | 充值的电话号码 |
| url | string | 支付宝充值链接 |
| ots | string | 订单创建时间,用于查询状态 |
| order_id | string | 订单ID |
```jsonld!
{
"code": 200,
"msg": "",
"data": {
"id": "1058889086460497920",
"pluginName": "gome-alipay-h5",
"addTime": "2022-12-31T23:27:11.420721",
"endTime": "2022-12-31T23:27:11.420743",
"amount": 100,
"state": "pending",
"payUrl": "https://mapi.alipay.com/gateway.do?_input_charset=utf-8&body=%E7%9C%9F%E5%BF%AB%E4%B9%90%E5%95%86%E5%93%81&it_b_pay=720m¬ify_url=http%3A%2F%2Fj.gpay.gome.com.cn%2Fcashierapi%2Fpay%2FALIPAYWAPVIRTON.dhtml&out_trade_no=10111800120441916966&partner=2088311598608551&payment_type=1&return_url=https%3A%2F%2Fwww.baidu.com&seller_email=gomefin002%40yolo24.com&seller_id=2088311598608551&service=alipay.wap.create.direct.pay.by.user&subject=%E7%9C%9F%E5%BF%AB%E4%B9%90%E5%95%86%E5%93%81-10111800120441916966&total_fee=100&sign=197379f6704aa457c3b78609c4a76c94&sign_type=MD5",
"pluginOrderId": "1UC2NUC0305RQEAR",
"pluginParameter1": "",
"pluginParameter2": "",
"requestId": "",
"callback": ""
}
}
```
支付宝启动:
1. alipays://platformapi/startapp?appId=20000067&url=(URL全编码)
1. alipays://platformapi/startapp?appId=20000987&url=(URL全编码)
如:
```
alipays://platformapi/startapp?appId=20000067&url=https%3A%2F%2Fmapi.alipay.com%2Fgateway.do%3F_input_charset%3Dutf-8%26body%3D%25E7%259C%259F%25E5%25BF%25AB%25E4%25B9%2590%25E5%2595%2586%25E5%2593%2581%26it_b_pay%3D721m%26notify_url%3Dhttp%253A%252F%252Fj.gpay.gome.com.cn%252Fcashierapi%252Fpay%252FALIPAYWAPVIRTON.dhtml%26out_trade_no%3D10111800120438313966%26partner%3D2088311598608551%26payment_type%3D1%26return_url%3Dhttps%253A%252F%252Fwww.baidu.com%26seller_email%3Dgomefin002%2540yolo24.com%26seller_id%3D2088311598608551%26service%3Dalipay.wap.create.direct.pay.by.user%26subject%3D%25E7%259C%259F%25E5%25BF%25AB%25E4%25B9%2590%25E5%2595%2586%25E5%2593%2581-10111800120438313966%26total_fee%3D100%26sign%3D10d49a8d07aab033124c976a7e174215%26sign_type%3DMD5
```