# 分配分账号流量接口-集团账号1.0

### 接口描述

```
1、集团账号给分账号分配或回收流量接口
2、接口支持https协议
```

### 接口URL

```
http://api.polyv.net/v2/group/vod/set-flow
```

### 请求方式

```
POST
```

### 接口约束

1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，[详细请查看](https://git.polyv.net/help-center/document-center/-/blob/master/live/api/limit/README.md)

### 请求参数描述

| 参数名       | 必选    | 类型      | 说明                                                                                                                                                                                                        |
| --------- | ----- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| appId     | true  | String  | 集团主账号appId【详见[集团账号2.0获取密钥](https://git.polyv.net/help-center/document-center/-/blob/master/live/api/getGroupSecretKey/README.md)】                                                                         |
| timestamp | true  | Long    | 当前13位毫秒级时间戳，3分钟内有效                                                                                                                                                                                        |
| sign      | true  | String  | 签名，为32位大写的MD5值,`生成签名的appSecret密钥作为通信数据安全的关键信息，严禁保存在客户端直接使用，所有API都必须通过客户自己服务器中转调用POLYV服务器获取响应数据`【详见[签名生成规则](https://git.polyv.net/help-center/document-center/-/blob/master/live/api/buildSign/README.md)】 |
| email     | true  | String  | 分帐号邮箱                                                                                                                                                                                                     |
| type      | false | String  | 添加-add,回收-recover。默认为add                                                                                                                                                                                  |
| all       | false | Integer | 是否回收所有，1-为回收所有。仅type为recover有效                                                                                                                                                                            |

### 示例

```requestUrl
```

### 响应参数描述

| 参数名     | 类型      | 说明                                                                                                                               |
| ------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- |
| code    | Integer | 响应状态码，200为成功返回，非200为失败【详见[全局错误说明](https://git.polyv.net/help-center/document-center/-/blob/master/live/api/errorInfo/README.md)】 |
| status  | String  | 响应状态文本信息                                                                                                                         |
| message | String  | 响应描述信息，当code为400或者500的时候，辅助描述错误原因                                                                                                |
| data    | String  | 请求成功返回success，请求失败为空字符串                                                                                                          |

### php请求示例

```php
<?php
//引用config.php
include 'config-group.php';

$params = array(
  'appId' => $appId,
  'timestamp' => $timestamp,
  'email' => 'email@polyv.net',
  'type' => 'recover',
  'all' => '1'
);

//生成sign
$sign = getSign($params); //详细查看config.php文件的getSign方法
$params['sign'] = $sign;

$url = "https://api.polyv.net/v2/group/vod/set-flow?".http_build_query($params);

$curl = curl_init();
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 500);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, 0);
$res = curl_exec($curl);
curl_close($curl);

echo $res;
?>
```

### 响应示例

成功示例

```json
{
    "code":200,
    "status":"success",
    "message":"success"
}

```

异常示例

```json
{
    "code": 403,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}
```
