分配流量 (Assign Traffic)
1. 接口描述
从主账号的可用余额中提取指定数额的流量,并分配给特定的子账号。
- 请求方式:
POST - 接口地址:
https://api.cueip.com/api/dynamic-proxy/sub-accounts/deliver-traffic - 内容类型:
application/json
2. 请求头规范 (Header)
所有请求必须包含以下安全校验字段。
| 字段名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| X-APP-ID | String | 是 | 应用唯一标识 (appId) | 10001 |
| X-NONCE | String | 是 | 随机数 | k9m2Pq7wL1 |
| X-TIMESTAMP | Long | 是 | 当前 Unix 时间戳 (秒) | 1713165000 |
| X-SIGN | String | 是 | 动态签名 | d3b1... |
签名生成逻辑请参考:签名生成指南
3. 请求参数 (Body)
请求体需传入 JSON 格式的对象。
| 参数名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| accountId | Long | 是 | 接收流量的子账号 ID | 6616436 |
| traffic | Number | 是 | 准备分配的流量值(单位:GB) | 10 |
4. 请求示例
http
POST /api/dynamic-proxy/sub-accounts/deliver-traffic
Host: api.cueip.com
X-APP-ID: 10001
X-NONCE: k9m2Pq7wL1
X-TIMESTAMP: 1713165000
X-SIGN: d3b1f92b3c4d5e6f7a8b9c0d1e2f3a4b
Content-Type: application/json
{
"accountId": 6616436,
"traffic": 10
}5. 响应参数说明
成功响应 (200 OK)
| 字段名 | 类型 | 描述 |
|---|---|---|
code | Integer | 状态码,0 表示分配成功 |
data | Boolean | 执行结果:true 成功 |
msg | String | 提示信息 |
响应示例
json
{
"code": 0,
"data": true,
"msg": "success"
}