cainiao.yima.relationship.customer.list (查询消费者列表)

查询消费者列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
execute_user_list ExecuteUserDto [] 必须
  • 最大列表长度:20
  • 用户列表
    • └ execute_user_id
    • Number
    • 可选
    • 34234
    • 用户id
    • └ execute_user_type
    • String
    • 可选
    • FWD
    • 用户类型
    page_number Number 可选 1 页码从1开始
    page_size Number 可选 25 页大小默认值25
    personal_session String 必须 sadsa33 个人session
    personal_user_id Number 必须 234234 个人id
    user_id String 可选 324234 企业账号id

    响应参数

    名称 类型 示例值 描述
    data MarketingCustomerListDto data
    • └ current_page
    • Number
    • 当前页码,从1开始
    • └ has_more
    • Boolean
    • 是否还有更多
    • └ last_month_customer_count
    • Number
    • 近一月下单用户总数
    • new_user_list
    • Newuserlist []
    • 近一月新用户列表
    • └ last_order_time
    • String
    • 最近一次下单时间
    • └ nickname
    • String
    • 消费者昵称
    • └ total_order_count
    • String
    • 下单总领
    • └ next_page
    • Number
    • 下一页的页码
    • old_user_list
    • MarketingCustomerDto []
    • 一个月之前的用户列表
    • └ last_order_time
    • String
    • 最近一次下单时间
    • └ nickname
    • String
    • 消费者昵称
    • └ total_order_count
    • String
    • 下单总数
    • └ total_customer_count
    • Number
    • 消费者总数
    • └ total_order_count
    • Number
    • 下单总量
    • └ has_old_user
    • Boolean
    • 是否有老用户
    • └ has_new_user
    • Boolean
    • 是否有新用户
    status_code String 2 statusCode
    status_message String statusMessage
    is_success Boolean false success

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CainiaoYimaRelationshipCustomerListRequest req = new CainiaoYimaRelationshipCustomerListRequest();
    List<CainiaoYimaRelationshipCustomerListRequest.ExecuteUserDto> list2 = new ArrayList<CainiaoYimaRelationshipCustomerListRequest.ExecuteUserDto>();
    CainiaoYimaRelationshipCustomerListRequest.ExecuteUserDto obj3 = new CainiaoYimaRelationshipCustomerListRequest.ExecuteUserDto();
    list2.add(obj3);
    obj3.setExecuteUserId(34234L);
    obj3.setExecuteUserType("FWD");
    req.setExecuteUserList(list2);
    req.setPageNumber(1L);
    req.setPageSize(25L);
    req.setPersonalSession("sadsa33");
    req.setPersonalUserId(234234L);
    req.setUserId("324234");
    CainiaoYimaRelationshipCustomerListResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <cainiao_yima_relationship_customer_list_response>
        <data>
            <current_page></current_page>
            <has_more></has_more>
            <last_month_customer_count></last_month_customer_count>
            <new_user_list>
                <newuserlist>
                    <last_order_time></last_order_time>
                    <nickname></nickname>
                    <total_order_count></total_order_count>
                </newuserlist>
            </new_user_list>
            <next_page></next_page>
            <old_user_list>
                <marketing_customer_dto>
                    <last_order_time></last_order_time>
                    <nickname></nickname>
                    <total_order_count></total_order_count>
                </marketing_customer_dto>
            </old_user_list>
            <total_customer_count></total_customer_count>
            <total_order_count></total_order_count>
            <has_old_user></has_old_user>
            <has_new_user></has_new_user>
        </data>
        <status_code>2</status_code>
        <status_message></status_message>
        <is_success>false</is_success>
    </cainiao_yima_relationship_customer_list_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

    返回
    顶部