文档中心 > API类目 > 菜鸟无线API

cainiao.yima.app.taskcenter.get (菜鸟包裹侠任务中心)

从app任务中心查询任务列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
app_version String 必须 1234 app版本
execute_user_list ExecuteUserDto [] 可选
  • 最大列表长度:20
  • 账号List
    • └ execute_user_id
    • Number
    • 可选
    • 4398050052418
    • 执行人账号id
    • └ execute_user_type
    • String
    • 可选
    • CP
    • 执行人账号类型
    ext String 可选 {"cp_code":"PERSONAL_CP_MOBILE","longitude":120.07630948827943,"latitude":30.287592157714148} 扩展参数
    personal_session String 必须 1212121212 用户会话唯一标识
    personal_user_id String 必须 34455555 个人用户Id

    响应参数

    名称 类型 示例值 描述
    data TaskCommandResponse [] 数据结构体
    • commands
    • TaskCommandDto []
    • 命令任务列表
    • └ action
    • String
    • {"a":"aa","b":"bb"}
    • 返回的业务参数
    • └ action_name
    • String
    • sop_workwear_verification
    • Action任务名称
    • └ action_type
    • String
    • cloth_check
    • Action任务类型
    • └ action_version
    • String
    • 12
    • Action任务版本号
    status_code String 2 错误编码
    status_message String 参数不正确 错误码描述
    is_success Boolean false 接口是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CainiaoYimaAppTaskcenterGetRequest req = new CainiaoYimaAppTaskcenterGetRequest();
    req.setAppVersion("1234");
    List<CainiaoYimaAppTaskcenterGetRequest.ExecuteUserDto> list2 = new ArrayList<CainiaoYimaAppTaskcenterGetRequest.ExecuteUserDto>();
    CainiaoYimaAppTaskcenterGetRequest.ExecuteUserDto obj3 = new CainiaoYimaAppTaskcenterGetRequest.ExecuteUserDto();
    list2.add(obj3);
    obj3.setExecuteUserId(4398050052418L);
    obj3.setExecuteUserType("CP");
    req.setExecuteUserList(list2);
    req.setExt("{\"cp_code\":\"PERSONAL_CP_MOBILE\",\"longitude\":120.07630948827943,\"latitude\":30.287592157714148}");
    req.setPersonalSession("1212121212");
    req.setPersonalUserId("34455555");
    CainiaoYimaAppTaskcenterGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <cainiao_yima_app_taskcenter_get_response>
        <data>
            <commands>
                <task_command_dto>
                    <action>{&quot;a&quot;:&quot;aa&quot;,&quot;b&quot;:&quot;bb&quot;}</action>
                    <action_name>sop_workwear_verification</action_name>
                    <action_type>cloth_check</action_type>
                    <action_version>12</action_version>
                </task_command_dto>
            </commands>
        </data>
        <status_code>2</status_code>
        <status_message>参数不正确</status_message>
        <is_success>false</is_success>
    </cainiao_yima_app_taskcenter_get_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

    返回
    顶部