文档中心 > API类目 > CRM猎户座前台

qimen.alibaba.okki.ai.reach.prospects.records.query (AiReach售前工具-查询潜客量级记录列表)

AiReach售前工具-查询潜客量级记录列表

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
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。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
crm_user_id	String	必须	ytest001		CRM用户ID
page_size	Number	必须	10	默认值：10	每页条数
page_num	Number	必须	1	默认值：1	当前页号

响应参数

名称	类型	示例值	描述
resp_code	String	0	0表示成功，-1表示失败
error_desc	String	system_error	错误描述
success	Boolean	true	是否成功
total	Number	100	结果总条数
page_size	Number	10	每页条数
page_num	Number	1	当前页号
ai_reach_prospects_record	OkkiAiReachProspectsRecord []		潜客查询记录列表
└ company_name String testCompany 公司名称 └ global_id String 1234321232 先富客户GID └ search_time String 2025-12-02 13:32:24 检索时间 └ status String SUCCESS 检索状态，SUCCESS-成功、FAILURE-失败、PENDING-处理中 └ search_result Number 25000 检索结果 └ remark String 检索失败备注，可以放检索错误信息 └ independent_website String https://crm.alibaba.com/ 独立站网址 └ ali_cn_website String https://crm.alibaba-inc.com/ 国际站网址

请求示例

{"page_num":1,"crm_user_id":"ytest001","page_size":10}

响应示例

{
    "resp_code":"0",
    "error_desc":"system_error",
    "success":true,
    "total":100,
    "page_size":10,
    "page_num":1,
    "ai_reach_prospects_record":[
        {
                "company_name":"testCompany",
                "global_id":"1234321232",
                "search_time":"2025-12-02 13:32:24",
                "status":"SUCCESS",
                "search_result":25000,
                "remark":"检索失败",
                "independent_website":"https:\/\/crm.alibaba.com\/",
                "ali_cn_website":"https:\/\/crm.alibaba-inc.com\/"
        }
    ]
}

验签示例

{"success":"不等于true","error_desc":"Illegal request","resp_code":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部