开放接口完成

tests/agent_open_api/README.md

@@ -0,0 +1,61 @@
+# 代理开放接口第三方对接示例
+
+本目录是按 Apifox 文档实现的第三方调用示例，不依赖当前项目内部包。
+
+## 默认配置
+
+- 服务地址：`https://cmp-api.boss160.cn`
+- 账号：`15571055000`
+- 密码：`Admin@123456`
+
+也可以通过环境变量覆盖：
+
+```bash
+AGENT_OPEN_API_BASE_URL=https://cmp-api.boss160.cn \
+AGENT_OPEN_API_ACCOUNT=15571055000 \
+AGENT_OPEN_API_PASSWORD='Admin@123456' \
+go run ./tests/agent_open_api -action wallet-balance
+```
+
+## 支持的 action
+
+```bash
+# 查询预充值钱包余额
+go run ./tests/agent_open_api -action wallet-balance
+
+# 查询套餐列表
+go run ./tests/agent_open_api -action packages -page 1 -page-size 20
+
+# 查询单卡实名状态
+go run ./tests/agent_open_api -action realname-status -card-no <ICCID或虚拟号或MSISDN>
+
+# 查询单卡状态
+go run ./tests/agent_open_api -action card-status -card-no <ICCID或虚拟号或MSISDN>
+
+# 查询单卡流量
+go run ./tests/agent_open_api -action card-traffic -card-no <ICCID或虚拟号或MSISDN>
+
+# 查询预充值钱包流水
+go run ./tests/agent_open_api -action wallet-transactions -page 1 -page-size 20
+
+# 钱包套餐购买，会真实创建订单，必须显式传入该 action
+go run ./tests/agent_open_api -action package-order -card-nos <卡1,卡2> -package-code <套餐编码>
+```
+
+## 签名规则
+
+每个请求携带 `X-Agent-Account`、`X-Agent-Password`、`X-Agent-Timestamp`、`X-Agent-Nonce`、`X-Agent-Sign`。
+
+签名原文按以下 7 行拼接，最后一行后不追加换行：
+
+```text
+METHOD
+PATH
+canonical_query
+body_sha256
+timestamp
+nonce
+account
+```
+
+`canonical_query` 会排除 `sign` 参数，参数名升序，同名多值按值升序，并使用 URL QueryEscape 编码。`body_sha256` 使用最终发送请求体字节计算，GET 和空 body 使用空字符串的 SHA256。