流程步骤：
步骤1.商户进入管理后台-数据中心-询盘管理-询盘设置-设置询盘同步到外部系统-使用API密钥对接，创建API密钥。
步骤2.向 https://api-qqt.weyescloud.com/external/inquiry/query 发起GET请求。
API接口说明
url: https://api-qqt.weyescloud.com/external/inquiry/query
参数说明
| 变量名 | 类型 | 必填 | 示例值 | 描述 |
| app_key | string(32) | 是 | ddb4851bdc3f7499beeed1a381fb0d13 | 创建API密钥返回的app key |
| page_number | int | 否 | 1 | 当前页数 |
| page_size | int | 否 | 10 | 每页返回询盘数量，最大不能超过20 |
| sign | string(32) | 是 | D676748F251C3A28C16D4B95FBB4ED33 | 签名，通过签名算法计算得出的签名值，详见签名生成算法 |
| nonce_str | string(32) | 是 | ibuaiVcKdpRxkhJA | 随机字符串，长度要求在32位以内 |
返回说明：
正确时返回的JSON数据包如下：
{
"req_id": "690d5f1fd450b863",
"req_time": 1762483999.869012,
"code": 0,
"msg": "ok",
"data": {
"total": 1501,
"page_count": 76,
"page_number": 1,
"page_size": 20,
"list": [
{
"id": 15926,
"client_id": 1,
"inquiry_id": 15926,
"contacts": "11 22",
"phone": "13798190341",
"company_name": "",
"content": "sdfsdf",
"create_time": "2025-07-22 20:53:09",
"update_time": "2025-07-22 20:53:09",
"site_id": 1,
"visitor_code": "1735111622528274",
"member_id": 4296,
"sync_platform_id": "",
"language_code": "en",
"type": 1,
"email": "291740904@qq.com",
"ip": "192.168.19.95",
"ip_country": "未知",
"client_account_ids": "",
"page_url": "http://localhost:1901/?url=oybmngpz.dweyes.cn&design=1&language_code=en",
"referrer": "http://localhost:1902/",
"source": 7,
"status": 0,
"inquiry_group_id": 0,
"customer_type": 0,
"is_read": 0,
"is_junk": 0,
"junk_rule": "",
"junk_reason": "",
"junk_time": 0,
"remark": "",
"source_campaign": "",
"keyword": "",
"is_delete": 0,
"confidence": "0.00000000",
"inquiry_email_sending_record_id": 0,
"opearing_system": "Windows",
"access_device": "PC",
"screen": "1920x1080",
"brower": "Chrome",
"custom_config": []
}
]
}
}
失败时返回：
{
"req_id": "690ee5661577ecd6",
"req_time": 1762583910.087449,
"code": 101,
"msg": "sign参数不能为空",
"data": []
}
返回参数说明
| 变量名 | 类型 | 必填 | 示例值 | 描述 |
| code | int | 是 | 0 | 错误码，成功时返回0，详见错误码说明 |
| msg | string | 是 | sign参数不能为空 | 错误信息描述 |
| data | array | 是 | [] | 数据 |
| data.total | int | 是 | 1501 | 询盘总数量 |
| data.page_count | int | 是 | 76 | 总页数 |
| data.page_number | int | 是 | 1 | 当前页 |
| data.page_size | int | 是 | 20 | 每页返回询盘数量 |
| data.list | array | 是 | 询盘列表 | |
| data.list[0].id | int | 是 | 1 | 询盘id |
| data.list[0].contacts | string(300) | 是 | Alex Summers | 联系人姓名 |
| data.list[0].phone | string(64) | 否 | 13700000000 | 联系电话 |
| data.list[0].company_name | string(255) | 否 | 公司名称 | |
| data.list[0].content | string(50000) | 是 | 询盘内容 | |
| data.list[0].email | string(255) | 是 | abc@abc.com | 邮箱 |
| data.list[0].ip | string(64) | 是 | 89.58.41.0 | ip地址 |
| data.list[0].ip_country | string(32) | 是 | 德国 | 国家 |
| data.list[0].page_url | string(1000) | 是 | https://www.test.com.cn/test.html | 询盘URL |
| data.list[0].status | int | 是 | 1 | 分配状态，0-未分配；1-已分配 |
| data.list[0].source | int | 是 | 7 | 流量来源：1-AI聚合页；2-AI产品；3-AI文章；4-Google广告；5-Facebook广告；6- Linkedin 广告；7-自然页;14-TikTok广告 |
| data.list[0].create_time | string | 是 | 2025-07-22 20:53:09 | 询盘时间 |
| data.list[0].is_read | int | 是 | 1 | 是否已读，0-否；1-是 |
| data.list[0].is_junk | int | 是 | 0 | 是否垃圾询盘：0-否；1-是 |
| data.list[0].junk_rule | string(1000) | 否 | 手动移入垃圾询盘 | 命中垃圾询盘规则 |
| data.list[0].junk_reason | string(1000) | 否 | 手动加入垃圾询盘的原因 | |
| data.list[0].junk_time | int | 否 | 0 | 更新为垃圾询盘时间戳 |
| data.list[0].remark | string(512) | 否 | 备注 | |
| data.list[0].opearing_system | string(64) | 是 | Windows | 操作系统 |
| data.list[0].access_device | string(64) | 是 | PC | 访问设备 |
| data.list[0].screen | string(64) | 是 | 1920x1080 | 屏幕分辨率 |
| data.list[0].brower | string(64) | 是 | Chrome | 浏览器 |
错误码
| 错误码 | 错误说明 |
| 100 | app_key参数不能为空 |
| 101 | sign参数不能为空 |
| 102 | 应用不存在，请去后台配置 |
| 103 | 签名验证失败 |
| 110 | 访问频次过多，请稍后再试 |
签名算法
签名生成的通用步骤如下：
第一步，设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。
特别注意以下重要规则：
1、参数名ASCII码从小到大排序（字典序）；
2、如果参数的值为空不参与签名；
3、参数名区分大小写；
4、验证调用返回签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验。
5、接口可能增加字段，验证签名时必须支持增加的扩展字段
第二步，在stringA最后拼接上API密钥（密钥在代码中字段名为key）得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。 注意：API密钥的长度为32个字节。
API密钥设置路径：管理后台->数据中心->询盘管理->询盘设置->设置询盘同步到外部系统->使用API密钥对接->创建API密钥
举例：
假设传送的参数如下：
app_key： ddb4851bdc3f7499beeed1a381fb0d13
page_number： 1
page_size： 10
nonce_str： ibuaiVcKdpRxkhJA
第一步：对参数按照key=value的格式，并按照参数名ASCII字典序排序如下：
stringA="app_key=ddb4851bdc3f7499beeed1a381fb0d13&nonce_str=ibuaiVcKdpRxkhJA&page_number=1&page_size=10";
第二步：拼接API密钥：
MD5签名方式：
stringSignTemp=stringA+"&key=f5b1e51dfd9e0102a08841c218f353c9" //注：key为商户平台设置的密钥key
sign=MD5(stringSignTemp).toUpperCase()="D676748F251C3A28C16D4B95FBB4ED33" //注：MD5签名方式