数据库备份
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# PlayX 调用积分商城接口说明
|
||||
# playX 调用积分商城接口说明
|
||||
|
||||
本文档描述 **PlayX 平台（或 PlayX 侧脚本/服务）如何调用积分商城已开放的 HTTP 接口**：基础约定、推荐流程、鉴权方式、请求参数与返回结构。
|
||||
本文档描述 **playX 平台（或 playX 侧脚本/服务）如何调用积分商城已开放的 HTTP 接口**：基础约定、推荐流程、鉴权方式、请求参数与返回结构。
|
||||
|
||||
实现依据：`config/route.php`、`app/api/controller/v1/Playx.php`、`config/playx.php`。
|
||||
|
||||
@@ -68,13 +68,13 @@
|
||||
|
||||
## 2. 使用流程（推荐）
|
||||
|
||||
### 2.1 PlayX 服务端 → 商城：每日数据推送（主流程）
|
||||
### 2.1 playX 服务端 → 商城：每日数据推送（主流程）
|
||||
|
||||
适用于 T+1 等业务数据由 **PlayX 服务端**主动推送到积分商城。
|
||||
适用于 T+1 等业务数据由 **playX 服务端**主动推送到积分商城。
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant PX as PlayX 服务端
|
||||
participant PX as playX 服务端
|
||||
participant M as 积分商城
|
||||
|
||||
Note over PX,M: 按约定配置 HMAC 密钥
|
||||
@@ -88,24 +88,20 @@ sequenceDiagram
|
||||
|
||||
### 2.2 用户侧（H5 / 内嵌页）→ 商城：会话与业务接口
|
||||
|
||||
以下接口多由 **用户在浏览器内**打开积分商城 H5 后调用，通过 **`session_id`**（先调 `verifyToken` 获取）或 **`token`**（商城 `muser` 类 token）标识用户，**不一定由 PlayX 后端直接调用**：
|
||||
以下接口多由 **用户在浏览器内**打开积分商城 H5 后调用，通过 **`session_id`**（先调 `verifyToken` 获取）或 **`token`**（商城 `muser` 类 token）标识用户，**不一定由 playX 后端直接调用**：
|
||||
|
||||
- `POST /api/v1/mall/verifyToken`：用 PlayX token 换商城 `session_id`
|
||||
- `POST /api/v1/mall/verifyToken`：用 playX token 换商城 `session_id`
|
||||
- `GET /api/v1/mall/assets`：查询资产
|
||||
- `POST /api/v1/mall/claim`：领取积分
|
||||
- `GET /api/v1/mall/items`：商品列表
|
||||
- `POST /api/v1/mall/bonusRedeem` / `physicalRedeem` / `withdrawApply`：兑换与提现申请
|
||||
- `GET /api/v1/mall/orders`：订单列表
|
||||
|
||||
若 PlayX 后端需要代替用户调用上述接口，须同样携带有效的 `session_id` 或 `token`，并遵守同一用户身份规则（见 **§4 身份说明**）。
|
||||
|
||||
### 2.3 代理鉴权（非 PlayX 通用）
|
||||
|
||||
`GET /api/v1/authToken` 为 **渠道/代理**签名换 JWT（`authtoken`），与 PlayX 用户体系不同，一般不在本文「PlayX 平台对接」主流程中展开；需要时由运营向商城索取单独说明。
|
||||
若 playX 后端需要代替用户调用上述接口，须同样携带有效的 `session_id` 或 `token`，并遵守同一用户身份规则（见 **§4 身份说明**）。
|
||||
|
||||
---
|
||||
|
||||
## 3. PlayX 服务端推送：Daily Push
|
||||
## 3. playX 服务端推送：Daily Push
|
||||
|
||||
### 3.1 概要
|
||||
|
||||
@@ -157,7 +153,7 @@ expected = HMAC_SHA256( canonical , PLAYX_DAILY_PUSH_SECRET )
|
||||
|------|------|------|------|
|
||||
| `request_id` | string | 是 | 本次推送请求号；响应中原样返回 |
|
||||
| `date` | string | 是 | 业务日期，格式 `YYYY-MM-DD` |
|
||||
| `user_id` | string | 是 | PlayX 用户 ID（幂等键之一） |
|
||||
| `user_id` | string | 是 | playX 用户 ID（幂等键之一） |
|
||||
| `username` | string | 否 | 展示名；用于同步/创建商城侧用户资产展示信息 |
|
||||
| `yesterday_win_loss_net` | number | 否 | 昨日净输赢；**小于 0** 时按配置比例计入待领取保障金（`locked_points`） |
|
||||
| `yesterday_total_deposit` | number | 否 | 昨日总充值；用于计算当日可领取上限等 |
|
||||
@@ -168,12 +164,12 @@ expected = HMAC_SHA256( canonical , PLAYX_DAILY_PUSH_SECRET )
|
||||
| 字段 | 类型 | 必填 | 说明 |
|
||||
|------|------|------|------|
|
||||
| `report_date` | string/number | 是 | 报表日期；可以为 Unix 秒时间戳（如 `1700000000`）或 `YYYY-MM-DD` |
|
||||
| `member` | array | 是 | 成员列表，每个成员包含一名 PlayX 用户数据 |
|
||||
| `member` | array | 是 | 成员列表，每个成员包含一名 playX 用户数据 |
|
||||
|
||||
成员元素字段：
|
||||
| 字段 | 类型 | 必填 | 说明 |
|
||||
|------|------|------|------|
|
||||
| `member_id` | string | 是 | PlayX 用户 ID（幂等键之一） |
|
||||
| `member_id` | string | 是 | playX 用户 ID（幂等键之一） |
|
||||
| `login` | string | 否 | 用户展示名 |
|
||||
| `yesterday_total_w` | number | 否 | 昨日净输赢；小于 0 才会累加到 `locked_points` |
|
||||
| `yesterday_total_deposit` | number | 否 | 昨日总充值；用于计算 `today_limit` |
|
||||
@@ -281,20 +277,20 @@ curl -X POST 'https://{商城域名}/api/v1/mall/dailyPush' \
|
||||
|
||||
### 5.1 `POST /api/v1/mall/verifyToken`
|
||||
|
||||
用于将 **PlayX token**（或本地联调 token）换 **商城 `session_id`**。
|
||||
用于将 **playX token**（或本地联调 token）换 **商城 `session_id`**。
|
||||
|
||||
| 参数位置 | 名称 | 说明 |
|
||||
|----------|------|------|
|
||||
| POST/GET | `token` 或 `session` | PlayX 或商城 token |
|
||||
| POST/GET | `token` 或 `session` | playX 或商城 token |
|
||||
|
||||
**说明：** 若 `playx.verify_token_local_only=true`（默认），商城**仅本地校验** token，不请求 PlayX 远程接口；远程模式需配置 `PLAYX_API_BASE_URL` 等。
|
||||
**说明：** 若 `playX.verify_token_local_only=true`（默认），商城**仅本地校验** token，不请求 playX 远程接口；远程模式需配置 `PLAYX_API_BASE_URL` 等。
|
||||
|
||||
**成功 `data` 示例：**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| `session_id` | 后续接口可带此字段 |
|
||||
| `user_id` | PlayX 用户 ID 或映射后的标识 |
|
||||
| `user_id` | playX 用户 ID 或映射后的标识 |
|
||||
| `username` | 用户名 |
|
||||
| `token_expire_at` | ISO8601 过期时间 |
|
||||
|
||||
@@ -436,8 +432,8 @@ Body：
|
||||
| 环境变量 / 配置 | 作用 |
|
||||
|-----------------|------|
|
||||
| `PLAYX_DAILY_PUSH_SECRET` | 非空则 Daily Push 必须带合法 HMAC 头 |
|
||||
| `PLAYX_VERIFY_TOKEN_LOCAL_ONLY` | 为 true 时 verifyToken 不请求 PlayX 远程 |
|
||||
| `PLAYX_API_BASE_URL` | 商城调用 PlayX 接口时使用（与「PlayX 调商城」方向相反） |
|
||||
| `PLAYX_VERIFY_TOKEN_LOCAL_ONLY` | 为 true 时 verifyToken 不请求 playX 远程 |
|
||||
| `PLAYX_API_BASE_URL` | 商城调用 playX 接口时使用（与「playX 调商城」方向相反） |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user