文档中心 > API类目 > 千牛接口

taobao.qianniu.task.update (更新轻任务)

由任务执行者调用,sub_status,tag和memo至少提供一个

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
task_id Number 必须 123 任务ID
sub_status String 可选 1 子任务状态,由业务方自定义
status String 可选 1,2 状态值,多个以逗号分隔
tag String 可选 标签 任务标签
memo String 可选 备注 任务备注。当memo_mode为1时,memo将采用追加方式。
remind_time Number 可选 138087867556 提醒时间,时间的毫秒数
biz_param String 可选 a=b&c=d 应用自定义参数
remind_flag Number 可选 1 0为不提醒,1为全部提醒,2为PC提醒,3为移动提醒,4为已提醒,5为已忽略。
memo_mode Number 可选 0
  • 默认值:0
  • 表示memo字段的更新策略。如需采用追加方式的,请将此字段设置为1。
    priority Number 可选 1 默认填0,数字越大优化级越高。当前常用0和1.
    is_deleted Number 可选 0 0表示没有删除,1表示删除

    响应参数

    名称 类型 示例值 描述
    result Boolean true 是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    QianniuTaskUpdateRequest req = new QianniuTaskUpdateRequest();
    req.setTaskId(123L);
    req.setSubStatus("1");
    req.setStatus("1,2");
    req.setTag("标签");
    req.setMemo("备注");
    req.setRemindTime(138087867556L);
    req.setBizParam("a=b&c=d");
    req.setRemindFlag(1L);
    req.setMemoMode(0L);
    req.setPriority(1L);
    req.setIsDeleted(0L);
    QianniuTaskUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <qianniu_task_update_response>
        <result>true</result>
    </qianniu_task_update_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部