huang
93200a9074
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m57s
1.8 KiB
1.8 KiB
代理开放接口第三方对接示例
本目录是按 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。