手机号撞库查询 API 接口说明

功能概述

若第三方系统需要先通过手机号查询数据是否存在,再进行数据推送,可使用此接口。

接口信息

接口地址

http://v8.youlingsha.com/api/jsClue/mobile/search

注意 http://v8.youlingsha.com 需要替换为您真实的地址

请求方法

POST

请求头

{
    "Content-Type": "application/json"
}

说明Content-Type 指定请求体的格式为 JSON 类型。

请求体

请求体格式

请求体采用 application/json 格式编码。

请求参数

参数名 类型 是否必选 描述
token string 用于身份验证的令牌
phone string 需要查询的手机号码,格式为 11 位数字或者 md5(‘13800138000’),如 13800138000 或者 7945bd83237335e5376ff44d62e4f0ae

请求示例

{
    "token": "",
    "phone": "13800138000" 
}

或者 

{
    "token": "",
    "phone": "7945bd83237335e5376ff44d62e4f0ae" 
}

响应数据

响应参数

参数名 类型 描述
code number 响应状态码,200 表示成功
message string 响应消息,success 表示操作成功
data object 包含具体查询结果的数据对象
data.exists number 表示手机号对应的数据是否存在,1 表示存在,0 表示不存在

响应示例

{
    "code": 200,
    "message": "success",
    "data": {
        "exists": 1
    }
}

错误处理

若请求出现错误,响应状态码将不是 200,同时 message 字段会给出具体的错误信息

作者:admin  创建时间:2025-03-22 21:21
最后编辑:admin  更新时间:2025-10-20 09:25