抖音开放平台Logo
开发者文档
控制台
  • OpenAPI 列表
  • 移动/网站应用 OpenAPI SDK 总览
  • 状态码排查工具
  • 个人资料
  • 关系能力
  • 内容能力
  • 抖音
  • 场景跳转
  • 投稿任务
  • 创建投稿任务
  • 绑定视频
  • 核销投稿任务
  • 查询视频基础信息
  • 视频数据
  • 互动评论
  • 私信群聊
  • 企业号开放能力(内测结束暂不开放)
  • 生活服务开放能力
  • 工具能力
  • 服务市场开放能力
  • 小程序推广计划
  • 联合授权
  • 创建投稿任务

    收藏
    我的收藏

    接口说明

    • 一个任务仅允许设置单个核销查询条件,如需查询投稿产生的多个维度数据需创建多个任务

    使用限制

    • Quota限制:10000/天
    • QPS限制:100/秒

    基本信息

    名称描述
    HTTP URL
    https://open.douyin.com/task/posting/create/
    HTTP Method
    POST
    Scope
    task.posting.create
    权限要求

    需要申请权限。路径:抖音开放平台控制台 > 应用详情 > 权限管理 > 能力实验室 > 投稿任务权限

    请求参数

    请求头
    access-token必填String
    示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
    content-type必填String
    示例:application/json
    固定值"application/json"
    Body展开全部子属性
    end_time必填Int64
    示例:1234567891
    结束时间秒级时间戳
    start_time必填Int64
    示例:1234567890
    开始时间秒级时间戳
    task_condition必填Struct
    示例:{"condition":"collection","min_value":0,"max_value":100000}
    任务条件
    展开子属性
    task_name必填String
    示例:优惠券任务
    任务名称,长度不超过50个字符
    请求示例
    curl --location --request POST 'https://open.douyin.com/task/posting/create/' \ --header 'access-token: clt.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27****' \ --header 'Content-Type: application/json' \ --data-raw '{ "task_name": "测试投稿任务", "task_condition": { "condition": "digg", "min_value": 0, "max_value": 100 }, "start_time": 1682858145, "end_time": 1685000977 }'

    响应参数

    Body展开全部子属性
    dataStruct
    展开子属性
    extraStruct
    展开子属性
    响应示例
    正常响应示例异常响应示例
    { "data": { "task_id": "@72M0WCqtxuYGiwtkVUYFvH1itu8zRM8IaUCtRwbNa32+7uo2083g2PcEG70*****", "task_status": 1, "error_code": 0, "description": "" }, "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "202305051653529635CB4F099894095439", "now": 1683276833 } }
    切换单列布局

    错误码

    HTTP 状态码错误码错误码描述排查建议
    2002100005
    参数不合法
    检查入参
    2002100004
    系统繁忙,此时请开发者稍候再试
    平台内部错误,多次重试后仍未恢复,请联系平台OnCall
    2002118110
    请求过于频繁
    请求QPS不要超过100
    2002118200
    任务名称长度必须大于0且不超过50
    检查入参
    2002118201
    任务名称存在不合法字符
    检查入参
    2002118202
    任务条件不存在
    检查入参
    2002118203
    任务条件名称不合法
    检查入参
    2002118204
    任务条件边界值不合法
    检查入参
    2002118205
    任务开始时间不得晚于结束时间
    检查入参
    2002118206
    任务结束时间不得晚于当前时间
    检查入参
    2002118207
    任务生效时间不得超过31天
    检查入参