huangting/th-hotel-simple
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

提交一次全量代码

Browse Source
This commit is contained in:
andy
2026-07-09 11:59:34 +08:00
parent 855396e553
commit 9fa608f602
58 changed files with 8439 additions and 116 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
docs/project/requirements/M002-superagent-task-result-api-contract.md
View File

@@ -57,12 +57,15 @@ hotel_id + source_provider(默认 AGENTBUS) + source_channel(默认 EMAIL) + sou
| 环境变量 | 是否必填 | 中文说明 |
| --- | --- | --- |
| `SUPERAGENT_TASK_RESULT_HMAC_SECRET` | 是 | SuperAgent 任务结果入站签名密钥，只能通过 Secret 注入 |
| `SUPERAGENT_DEV_TASK_RESULT_HMAC_SECRET` | dev 必填 | dev SuperAgent 任务结果入站签名密钥，只能通过 Secret 注入 |
| `SUPERAGENT_TEST_TASK_RESULT_HMAC_SECRET` | test 必填 | test SuperAgent 任务结果入站签名密钥，只能通过 Secret 注入 |
| `SUPERAGENT_PROD_TASK_RESULT_HMAC_SECRET` | prod 必填 | prod SuperAgent 任务结果入站签名密钥，只能通过 Secret 注入 |
| `SUPERAGENT_TASK_RESULT_HMAC_SECRET` | 兼容兜底 | 旧通用 HMAC 变量；新环境优先配置环境专属变量 |
| `SUPERAGENT_TASK_RESULT_CLOCK_SKEW_SECONDS` | 否 | 请求时间允许偏移，默认 `300` 秒 |
| `SUPERAGENT_TASK_RESULT_NONCE_TTL_SECONDS` | 否 | Nonce 去重窗口，默认 `600` 秒 |
| `SUPERAGENT_TASK_RESULT_MAX_BODY_BYTES` | 否 | 请求体最大字节数，默认 `1048576` |
如果 `SUPERAGENT_TASK_RESULT_HMAC_SECRET` 为空，生产环境应拒绝接口调用。
如果当前 profile 对应的 `SUPERAGENT_*_TASK_RESULT_HMAC_SECRET` 和旧通用变量都为空，生产环境应拒绝接口调用。
### 3.2 请求 Header
@@ -92,7 +95,7 @@ POST
签名算法：
```text
signature = HMAC_SHA256(SUPERAGENT_TASK_RESULT_HMAC_SECRET, canonical_string)
signature = HMAC_SHA256(当前 profile 生效的 SuperAgent HMAC secret, canonical_string)
```
Header 写法：