注意:以下文档只适用于TOP接口,请谨慎使用!

yunos.ospush.open.push.task.result (发送结果实时查询接口)

发送结果实时查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
session_id String 必须 DX1234
  • 最大长度:64
  • 自定义随机字符串,用以标识本次调用。每次调用值不要相同
    task_id String 必须 1234
  • 最大长度:64
  • 透传接口返回的taskId
    task_type Number 必须 1
  • 最大长度:5
  • 透传接口返回的type,1是圈定人群发送结果查询,2是指定特定设备查询。其中task_type=1的查询有效期只有15天,即发送的任务如果在15天后查询,是没有值的
    cond_map Json 可选 {} 备用参数,约定为Map类型,暂时不启用

    响应参数

    名称 类型 示例值 描述
    result TopResult result
    • model
    • TaskStatsResult
    • model
    • └ arrive_count
    • Number
    • 99
    • arriveCount
    • └ send_count
    • Number
    • 100
    • sendCount
    • └ session_id
    • String
    • DX1234
    • sessionId
    • └ code
    • String
    • 10000
    • 当code为10000时,才表示调用成功
    • └ msg
    • String
    • 操作成功
    • msg

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    YunosOspushOpenPushTaskResultRequest req = new YunosOspushOpenPushTaskResultRequest();
    req.setSessionId("DX1234");
    req.setTaskId("1234");
    req.setTaskType(1L);
    req.setCondMapString("{}");
    YunosOspushOpenPushTaskResultResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <yunos_ospush_open_push_task_result_response>
        <result>
            <model>
                <arrive_count>99</arrive_count>
                <send_count>100</send_count>
                <session_id>DX1234</session_id>
            </model>
            <code>10000</code>
            <msg>操作成功</msg>
        </result>
    </yunos_ospush_open_push_task_result_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.10020 push渠道非法 push渠道非法,请检查appkey是否被授权
    isv.10100 入参参数非法 返回的msg中有错误的明细信息,请对照
    isp.12010 查询类型错误 查询类型错误,请检查是否填入需要查询的type
    isp.12020 未找到发送记录 未找到发送记录,请检查输入的查询信息是否正确
    isp.12021 尚未有发送数据 可以等一会再来查询
    isp.12022 该任务的查询记录已过期 该任务的查询记录已过期,如果是指定标签发送人群的数据,请在15天内查询。
    isp.12030 查询失败 查询失败,可以联系管理员排查问题
    isv.12023 未能找到发送TASK 请检查输入的task信息

    API工具

    如何获得此API

    FAQ

    返回
    顶部