# 发布任务
### 接口地址：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 | 暂无 | 接口调用密钥 |
