脱敏运行配置和旧文档

2026-05-25 22:27:11 +08:00
parent 38c6323649
commit b1979eea94
32 changed files with 105 additions and 2938 deletions
@@ -27,7 +27,7 @@
 请按以下地址配置：

 ```text
-POST https://221329.cc.cd/api/v1/open/91/orders/create
+POST https://你的域名/api/v1/open/91/orders/create
 ```

 ## 4. 请求方式
@@ -97,7 +97,7 @@ your_secret_keybuyNum=1&callbackUrl=https://cb.example.com/notify/91/order&maxAm
 4. 若 `productNo` 已映射到快手 Cloud 履约商品，则创建履约任务；
 5. 若 `productNo` 尚未配置，则订单进入后台“待补全”队列，由运营补齐履约配置后重试生成任务；
 6. 若传入 `maxAmount`，则校验成本是否超限；
-7. 履约任务生成后，生成当前项目领取链接，例如：`https://221329.cc.cd/#/claim/{token}`；
+7. 履约任务生成后，生成当前项目领取链接，例如：`https://你的域名/#/claim/{token}`；
 8. 首次响应返回处理中状态，由 `91卡券` 后续调用查询订单接口获取最终卡密内容。

 ## 10. 响应参数
@@ -151,6 +151,6 @@ your_secret_keybuyNum=1&callbackUrl=https://cb.example.com/notify/91/order&maxAm
 - `productNo` 请按我方提供的商品编号配置；
 - 若 `productNo` 尚未配置，当前项目会先保存订单并返回 `orderStatus = 10`，后台补齐履约配置后可手动重试；
 - 本接口成功受理后，不代表最终卡密已可交付；
- 最终交付内容为我方系统生成的领取链接，链接域名固定为 `221329.cc.cd`；
+- 最终交付内容为我方系统生成的领取链接，链接域名按实际部署域名配置；
 - 该链接将在“查询订单接口”中，通过 `cards` 加密串返回；
 - 建议 `91卡券` 将此商品配置为：`异步卡密商品`。
@@ -21,7 +21,7 @@
 请按以下地址配置：

 ```text
-POST https://221329.cc.cd/api/v1/open/91/orders/query
+POST https://你的域名/api/v1/open/91/orders/query
 ```

 ## 4. 请求方式
@@ -96,7 +96,7 @@ your_secret_keyorderNo=P91KS202605040001&timestamp=1777867260&version=1.0your_se
 | `failReason` | string | 失败时建议返回 | 失败原因。 |
 | `orderCost` | decimal(14,4) | 成功时建议返回 | 订单总成本，单位：元。 |
 | `cards` | string | `orderStatus = 20` 时必须 | 卡密数据加密串。当前项目通过该字段返回领取链接。 |
-| `cards[0].cardNo` | string | 成功时必须 | 最终交付的领取链接，格式为 `https://221329.cc.cd/#/claim/{token}`。 |
+| `cards[0].cardNo` | string | 成功时必须 | 最终交付的领取链接，格式为 `https://你的域名/#/claim/{token}`。 |
 | `cards[0].cardPwd` | string | 可选 | 当前场景固定为空字符串。 |
 | `cards[0].expireTime` | string | 可选 | 领取链接过期时间，支持 `yyyy-MM-dd HH:mm:ss` 或 10 位秒级 Unix 时间戳。 |
 | `cards[0].jumpLink` | string | 可选 | 与 `cardNo` 保持一致，用于兼容链接展示场景。 |
@@ -115,10 +115,10 @@ your_secret_keyorderNo=P91KS202605040001&timestamp=1777867260&version=1.0your_se
 ```json
 [
  {
-    "cardNo": "https://221329.cc.cd/#/claim/abc123xyz",
+    "cardNo": "https://你的域名/#/claim/abc123xyz",
    "cardPwd": "",
    "expireTime": "2026-05-05 12:00:00",
-    "jumpLink": "https://221329.cc.cd/#/claim/abc123xyz"
+    "jumpLink": "https://你的域名/#/claim/abc123xyz"
  }
 ]
 ```
@@ -168,10 +168,10 @@ your_secret_keyorderNo=P91KS202605040001&timestamp=1777867260&version=1.0your_se
 ```json
 [
  {
-    "cardNo": "https://221329.cc.cd/#/claim/abc123xyz",
+    "cardNo": "https://你的域名/#/claim/abc123xyz",
    "cardPwd": "",
    "expireTime": "2026-05-05 12:00:00",
-    "jumpLink": "https://221329.cc.cd/#/claim/abc123xyz"
+    "jumpLink": "https://你的域名/#/claim/abc123xyz"
  }
 ]
 ```
@@ -198,7 +198,7 @@ your_secret_keyorderNo=P91KS202605040001&timestamp=1777867260&version=1.0your_se
 - 当返回 `orderStatus = 20` 时，表示我方已准备好最终交付内容；
 - 当返回 `orderStatus = 10` 时，可能是履约任务正在准备，也可能是后台正在补齐 `productNo` 对应的履约配置；
 - 最终交付内容是领取链接，不是传统卡号密码；
- 领取链接域名固定为 `221329.cc.cd`；
+- 领取链接域名按实际部署域名配置；
 - 买家收到链接后，会进入我方系统领取页完成后续快手核销与履约流程；
 - 建议 `91卡券` 侧确认：
  - `cards.cardNo` 可直接展示完整链接；
@@ -12,7 +12,7 @@

 ## 2. 对接结论

-本次对接不走 `Agiso/咸鱼` 的站内消息链路，而是走：
+本次对接采用独立开放接口链路：

 1. `91卡券` 调用我方异步下单接口；
 2. 我方创建内部订单，并生成领取链接；
@@ -4,8 +4,8 @@

 基于以下对外接口文档完成当前项目接入：

- [3.异步卡密下单.md](/Users/yml/codes/order-site-workspace/docs/91卡券/3.异步卡密下单.md:1)
- [4.查询订单接口.md](/Users/yml/codes/order-site-workspace/docs/91卡券/4.查询订单接口.md:1)
+- [3.异步卡密下单.md](./3.异步卡密下单.md)
+- [4.查询订单接口.md](./4.查询订单接口.md)

 目标能力：

@@ -13,13 +13,13 @@
 2. 我方将订单作为独立接入平台订单写入当前项目；
 3. 已配置商品自动走现有快手 Cloud 履约链路；
 4. 未配置商品进入后台待补全队列，可手动补齐履约信息后重试；
-5. 我方生成领取链接 `https://221329.cc.cd/#/claim/{token}`；
+5. 我方生成领取链接 `https://你的域名/#/claim/{token}`；
 6. `91卡券` 调用查询订单接口；
 7. 我方在 `cards` 中返回领取链接，由 `91卡券` 自动发货给买家。

 ## 2. 设计原则

- `91卡券` 作为**新的订单来源**，不复用 `agiso`。
+- `91卡券` 作为**独立订单来源**。
 - `91卡券` 不是新的履约执行器，而是外部售卖、订单输入和自动发货通道。
 - 当前项目真正的交付物仍然是 `claimUrl`。
 - 查询接口返回 `20` 的判断标准是“领取链接已生成并可发”，不是“快手最终兑换完成”。
@@ -37,7 +37,7 @@

 原因：

- 避免与 `agiso` webhook 语义混淆；
+- 避免与其他平台回调语义混淆；
 - 避免复用历史后台拉单来源；
 - 便于后续单独做日志、排障和绑定配置。

@@ -219,7 +219,7 @@ platforms: {

 ### 9.2 编码方案

-按 [卡密加密说明.md](/Users/yml/codes/order-site-workspace/docs/91卡券/卡密加密说明.md:1) 实现：
+按 [卡密加密说明.md](./卡密加密说明.md) 实现：

 - 算法：`AES`
 - 模式：`ECB`
@@ -1,12 +1,12 @@
 ### 简要描述：
- AES/加密模式ECB/填充PKCS7Padding/数据块128位 <font color='red'>注意：加密密钥为开放平台的AppSecret（从<a href='https://open.agiso.com/#/my/application/app-list' target='_blank'>open.agiso.com</a>上查看）</font>
+- AES/加密模式 ECB / 填充 PKCS7Padding / 数据块 128 位。加密密钥使用开放平台分配的 AppSecret。

 **假设cards为：** 
 ```
 [{"cardNo":"10001","cardPwd":"123456","expireTime":"2023-06-19 17:16:01"}]
 ```

-**假设开放平台的appSecret为：** <font color='red'>0a091b3aa4324435aab703142518a8f7</font>（从<a href='https://open.agiso.com/#/my/application/app-list' target='_blank'>open.agiso.com</a>上查看）
+**假设开放平台的 appSecret 为：** `00000000000000000000000000000000`

 ### .NET加密示例：

@@ -121,4 +121,4 @@ public class Main {
        System.out.println("最终加密结果: " + encrypted);
    }
 }
-```
+```