文档中心 > API类目 > 旺旺聊天记录

taobao.qianniu.cloudkefu.onlinestatuslog.get (查询客服在线状态)

按天查询客服账号的在线状态记录。如:登录,下线,挂起等 有别于taobao.qianniu.cloudkefu.statuslog.get接口,这个接口可以查询30天内的流水,不需要分页查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
account_ids String [] 必须 3613919119,3613919119
  • 最大列表长度:5
  • 子帐号列表,最多10个
    start_date Date 必须 1970-01-01 00:00:00 查询开始日期,只有日期有效,时间忽略
    end_date Date 必须 1970-01-01 00:00:00 查询结束日期,只有日期有效,时间忽略

    响应参数

    名称 类型 示例值 描述
    record_list RecordList [] module
    • └ main_account_id
    • Number
    • 3613919119
    • mainAccountId
    • └ status
    • Number
    • 1
    • 操作记录,1在线,-1离线,2挂起,3解挂
    • └ type
    • Number
    • 0
    • 记录类型,PC上下线:8;移动上下线:4;挂起类型:5
    • └ account_id
    • Number
    • 3613919119,3613919119
    • 查询记录的帐号ID
    • └ change_time_ts
    • Number
    • 1517903431367
    • 变更时间戳
    • └ change_time
    • Date
    • 2018-08-25 00:00:00
    • 变更时间
    • └ domain
    • String
    • cntaobao
    • 登陆域
    • └ gmt_create
    • Date
    • 2018-08-25 00:00:00
    • 创建时间
    cause Json cause
    error_map Json 123 errorMap
    attachment Json attachment
    solution String solution
    version Number version

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    QianniuCloudkefuOnlinestatuslogGetRequest req = new QianniuCloudkefuOnlinestatuslogGetRequest();
    req.setAccountIds("3613919119,3613919119");
    req.setStartDate(StringUtils.parseDateTime("1970-01-01 00:00:00"));
    req.setEndDate(StringUtils.parseDateTime("1970-01-01 00:00:00"));
    QianniuCloudkefuOnlinestatuslogGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <qianniu_cloudkefu_onlinestatuslog_get_response>
        <record_list>
            <record_list>
                <main_account_id>3613919119</main_account_id>
                <status>1</status>
                <type>0</type>
                <account_id>3613919119,3613919119</account_id>
                <change_time_ts>1517903431367</change_time_ts>
                <change_time>2018-08-25 00:00:00</change_time>
                <domain>cntaobao</domain>
                <gmt_create>2018-08-25 00:00:00</gmt_create>
            </record_list>
        </record_list>
        <cause></cause>
        <error_map>123</error_map>
        <attachment></attachment>
        <solution></solution>
        <version></version>
    </qianniu_cloudkefu_onlinestatuslog_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

    返回
    顶部