# 發布任務
### 接口地址：task/create 請求方式：POST
| 參數名稱 | 參數類型 | 是否必須 | 參數描述 |
|--------------|------------|------|-----------------------------------|
| name | string | 是 | 任務名稱 |
| start_at | timestamp | 是 | 任務開始時間 |
| end_at | timestamp | 否 | 任務截止時間，空時長期有效 |
| task_area | json | 否 | 任務發布范圍 |
| task_tag | json | 否 | 任務分類標簽1：轉發；2：閱讀 |
| subject | json | 否 | 話題ID |
| task | json | 是 | 任務詳情數組 |
| -type | int | 是 | 任務類型 :<br/>1.微信2.微博3.抖音 4.問卷 5.投票 |
| -task_config | json | 是 | 任務配置 |
#### 微信-任務配置
| 參數名稱 | 類型 |是否必填|描述|
| --- | --- |--- |--- |
| link | string | 否 | 鏈接地址 |
| title| string | 否 | 標題 |
| desc| string | 否 | 內容 |
| thumb| string | 否 | 頭圖 |
#### 微博-任務配置
| 參數名稱 | 類型 |是否必填|描述|
| --- | --- |--- |--- |
| link | string | 否 | 鏈接地址 |
| title| string | 否 | 標題 |
| desc| string | 否 | 內容 |
| thumb| string | 否 | 圖片地址 |
#### 抖音-任務配置
（圖集地址和視頻地址同時存在時，以視頻地址為準）
| 參數名稱 | 類型 |是否必填|描述|
| --- | --- |--- |--- |
| image\_list\_path| string | 否 | 圖集地址 ,英文逗號分隔 （單個圖片最大不超過20M，只支持：png/jpg）|
| video\_path| string | 否 | 視頻地址（只能單個，不能超過 128M，當前支持的格式包含 mp4/mov）|
### 完整示例
#### 簽名前的數據
~~~
$params = [
'app_id' => 1,
'timestamp' => time(),
'name' => '新任務001',
'start_at' => time(),
'end_at' => time() + 60 * 60 * 24 * 30,
'task_area' => json_encode([
1, 2, 3, 4
]),
'subject' => json_encode([
2, 3, 4
]),
'task_tag' => json_encode([
1, 2, 3, 4
]),
'task' => json_encode(
[
'type' => 1,
'task_config' => [
'link' => '',
'title' => '主持召開八場重磅會議！“既為一域增光、又為全局添彩”！'
]
])
];
~~~
#### 簽名后的數據（key:12345678901234567890123456789012）
```
{
"app_id": 1,
"timestamp": 1724134963,
"name": "",
"start_at": "2024-08-16 11:20:58",
"end_at": null,
"task_tag": "[2]",
"subject": "[2,3,4]",
"task_area": null,
"task": "{\"type\":2,\"task_config\":{\"link\":\"https:\\/\\/www.cq.gov.cn\\/ywdt\\/zwhd\\/bmdt\\/202408\\/t20240819_13517221.html\",\"thumb\":\"https:\\/\\/www.cq.gov.cn\\/images\\/name.png\",\"desc\":\"\"}}",
"sign": "4c3de37d75f4c47de49bb1d3869649c0"
}
```
# 返回結果
| 字段名稱 | 字段類型 | 字段描述 |
|---------|------|----------------|
| task_id | int | 創建成功則返回創建任務ID |
# 調用憑證
申請開通接口權限后，由平臺提供：
| 字段 | 字段值 | 字段描述 |
|-----------|-------|----------|
| base_url | 暫無 | 請求接口URL |
| app_id | 暫無 | 應用編號 |
| secret | 暫無 | 接口調用密鑰 |
