淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
lead_external_query_dto	LeadExternalQueryDTO	可选			查询实体
└ offset Number 可选 1231 对应的是id，不传默认从最新的开始取 └ page_size Number 必须 100 分页记录数

名称	类型	示例值	描述
result_data	Result []		result
└ seller_nick String XX**旗舰店商家昵称 └ gmt_modified Date 1694076956000 修改时间 └ mm_src_cname String 淘积木其他淘积木渠道来源 └ lead_time Date 2022-05-03 17:44:28 留资提交时间 └ seller_user_id Number 999999999 商家uid └ page_id Number 5314456 提交表单的页面id └ gmt_create Date 1694076956000 创建时间 └ page_name String 新半价2 表单名称 └ name String 三姓名 └ store_name String 测试店铺名店铺名 └ id Number 221985 主键 └ location_code String 111 区域code extend_list LeadExtendDTO [] [{"value": xxx,"label": xxx,"code": xxx}] 扩展信息 └ label String 性别值 └ code String sex code └ value String 男表单名称 └ location String xx省xx市xx县区域 └ mobile String Pci/6KXfTwzSw1GxkcpNePH4Ple2jKPKfDu3df3cXs3ISFXyxkp/73vvRgVBSvCRCfdSMCL1Fkz8yNyYTu0avTW28ISVQmf+E8WdiYmGfNCRpisEeZvY9dM7eFL930snpMl3IjQZxHpIeZm+wCOtc07I5vaogqMKQ7Ejn9MSXVE= 手机号码（加密，需解密）
result_ok	Boolean	true	是否调用成功
result_error_code	String	abcd	错误code
error_msg	String	查询失败原因	调用失败信息

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
MamaCrmLeadListRequest req = new MamaCrmLeadListRequest();
MamaCrmLeadListRequest.LeadExternalQueryDTO obj1 = new MamaCrmLeadListRequest.LeadExternalQueryDTO();
obj1.setOffset(1231L);
obj1.setPageSize(100L);
req.setLeadExternalQueryDto(obj1);
MamaCrmLeadListResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

XML示例
JSON示例

<mama_crm_lead_list_response>
    <result_data>
        <result>
            <seller_nick>XX****旗舰店</seller_nick>
            <gmt_modified>1694076956000</gmt_modified>
            <mm_src_cname>淘积木其他</mm_src_cname>
            <lead_time>2022-05-03 17:44:28</lead_time>
            <seller_user_id>999999999</seller_user_id>
            <page_id>5314456</page_id>
            <gmt_create>1694076956000</gmt_create>
            <page_name>新半价2</page_name>
            <name>**三</name>
            <store_name>测试店铺名</store_name>
            <id>221985</id>
            <location_code>111</location_code>
            <extend_list>
                <lead_extend_d_t_o>
                    <label>性别</label>
                    <code>sex</code>
                    <value>男</value>
                </lead_extend_d_t_o>
            </extend_list>
            <location>xx省xx市xx县</location>
            <mobile>Pci/6KXfTwzSw1GxkcpNePH4Ple2jKPKfDu3df3cXs3ISFXyxkp/73vvRgVBSvCRCfdSMCL1Fkz8yNyYTu0avTW28ISVQmf+E8WdiYmGfNCRpisEeZvY9dM7eFL930snpMl3IjQZxHpIeZm+wCOtc07I5vaogqMKQ7Ejn9MSXVE=</mobile>
        </result>
    </result_data>
    <result_ok>true</result_ok>
    <result_error_code>abcd</result_error_code>
    <error_msg>查询失败原因</error_msg>
</mama_crm_lead_list_response>

{
    "mama_crm_lead_list_response":{
        "result_data":{
            "result":[
                {
                    "seller_nick":"XX****旗舰店",
                    "gmt_modified":"1694076956000",
                    "mm_src_cname":"淘积木其他",
                    "lead_time":"2022-05-03 17:44:28",
                    "seller_user_id":999999999,
                    "page_id":5314456,
                    "gmt_create":"1694076956000",
                    "page_name":"新半价2",
                    "name":"**三",
                    "store_name":"测试店铺名",
                    "id":221985,
                    "location_code":"111",
                    "extend_list":{
                        "lead_extend_d_t_o":[
                            {
                                "label":"性别",
                                "code":"sex",
                                "value":"男"
                            }
                        ]
                    },
                    "location":"xx省xx市xx县",
                    "mobile":"Pci\/6KXfTwzSw1GxkcpNePH4Ple2jKPKfDu3df3cXs3ISFXyxkp\/73vvRgVBSvCRCfdSMCL1Fkz8yNyYTu0avTW28ISVQmf+E8WdiYmGfNCRpisEeZvY9dM7eFL930snpMl3IjQZxHpIeZm+wCOtc07I5vaogqMKQ7Ejn9MSXVE="
                }
            ]
        },
        "result_ok":true,
        "result_error_code":"abcd",
        "error_msg":"查询失败原因"
    }
}

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测试工具错误码查询工具 SDK下载

阿里妈妈API

taobao.mama.crm.lead.list (taobao.mama.crm.lead.list)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ