经销商 API 文档
接口概览
本站提供与 DHRU 经销商 API 一致的调用方式，你可以用「用户名 + API 密钥」查询余额、获取服务列表、下单并查询订单状态。 首次使用请在客户中心「API 接口」页启用 API 访问，系统会自动生成密钥。
认证参数
| 参数 | 必填 | 说明 |
|---|---|---|
| username | 是 | 客户中心显示的用户名 |
| apiaccesskey | 是 | API 密钥（也可用 api_key 传参） |
| action | 是 | balance / services / placeorder / orderstatus |
认证失败时返回 HTTP 401 与 {"status":false,"message":"认证失败..."}。
1. 查询余额 · balance
curl -X POST /api/reseller \ -d "username=yourname" \ -d "apiaccesskey=YOUR_API_KEY" \ -d "action=balance"
返回示例：
{"status":true,"data":{"username":"yourname","balance":12.5,"currency":"USD"}}
2. 服务列表 · services
curl -X POST /api/reseller \ -d "username=yourname" \ -d "apiaccesskey=YOUR_API_KEY" \ -d "action=services"
返回的每个服务包含 id、name、price、delivery、kind、group，下单时把 id 传给 placeorder 即可。
3. 下单 · placeorder
| 参数 | 必填 | 说明 |
|---|---|---|
| service | 是 | 服务 ID（也可传服务别名） |
| imei | 视服务而定 | IMEI，15 位数字 |
| sn | 视服务而定 | 序列号（服务要求时传） |
| 其他字段 | 视服务而定 | 服务详情页展示的字段名，如 Email、Password 等；字段名与认证参数冲突时请用 fields[字段名] 传值 |
下单成功后按服务价格从账户余额扣除；余额不足会直接返回错误。
curl -X POST /api/reseller \ -d "username=yourname" \ -d "apiaccesskey=YOUR_API_KEY" \ -d "action=placeorder" \ -d "service=123" \ -d "imei=356938035643809"
{"status":true,"data":{"order":{"no":"S20261031ABC123","status":"submitted","upstream_id":98765,"service_id":123,"price":2.5},"message":"订单提交成功"}}
4. 订单状态 · orderstatus
| 参数 | 必填 | 说明 |
|---|---|---|
| orderid | 是 | 本站订单号（如 S20261031ABC123）或上游订单号 |
curl -X POST /api/reseller \ -d "username=yourname" \ -d "apiaccesskey=YOUR_API_KEY" \ -d "action=orderstatus" \ -d "orderid=S20261031ABC123"
状态值：pending（等待提交）、submitted（处理中）、completed（已完成）、failed / cancelled（失败或取消）。
错误返回
{"status":false,"message":"余额不足，请先充值（当前余额 0.00 USD）"}
参数缺失、服务不存在、余额不足等情况返回 HTTP 400；认证失败返回 401；订单不存在返回 404。