junhong_cmp_fiber/tests/agent_open_api

代理开放接口第三方对接示例

本目录是按 Apifox 文档实现的第三方调用示例，不依赖当前项目内部包。

默认配置

• 服务地址：https://cmp-api.boss160.cn
• 账号：15571055000
• 密码：Admin@123456

也可以通过环境变量覆盖：

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

# 查询预充值钱包余额
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 行拼接，最后一行后不追加换行：

METHOD
PATH
canonical_query
body_sha256
timestamp
nonce
account

canonical_query 会排除 sign 参数，参数名升序，同名多值按值升序，并使用 URL QueryEscape 编码。body_sha256 使用最终发送请求体字节计算，GET 和空 body 使用空字符串的 SHA256。