1.7 KiB
1.7 KiB
agent-open-api 当前行为
Purpose
描述代理开放接口认证与店铺数据范围的当前行为。
Requirements
Requirement: 开放接口认证
系统 SHALL 在代理开放接口执行业务前校验调用方身份与请求签名。
Scenario: 开放接口认证
- GIVEN 请求缺少、伪造或过期的认证材料
- WHEN 调用任一代理开放接口
- THEN 请求被拒绝且不执行资源或资金变化
Requirement: 开放接口数据范围
系统 SHALL 仅允许代理访问其店铺数据范围内的卡、套餐和钱包。
Scenario: 开放接口数据范围
- GIVEN 代理请求其他店铺资源
- WHEN 查询或写入
- THEN 请求被统一拒绝且不泄露资源存在性
可达操作索引
本节只用于入口导航,不是行为 Requirement;业务义务以上述 Requirements 为准。
代理开放接口
GET /api/open/v1/cards/realname-status(查询单卡实名状态);POST /api/open/v1/cards/resume(机卡分离卡复机);GET /api/open/v1/cards/status(查询单卡状态);GET /api/open/v1/cards/traffic(查询单卡或设备流量);POST /api/open/v1/devices/reboot(重启设备);POST /api/open/v1/devices/reset(恢复出厂设置);POST /api/open/v1/devices/switch-card(切网(多卡设备切换 ICCID));GET /api/open/v1/devices/traffic(查询设备套餐内流量);GET /api/open/v1/packages(查询套餐列表);GET /api/open/v1/wallet/balance(查询预充值钱包余额);POST /api/open/v1/wallet/package-orders(钱包套餐购买);GET /api/open/v1/wallet/transactions(查询预充值钱包流水)。