手机号码 POST /v1/query/mo-geo

手机号码归属地

XS-API-MO-GEO · ¥0.0001 / 次

接口说明

查询手机号号段归属地及运营商。提交手机号码(mobile,必填)、返回语言(language,可选)。返回号段、在网状态、入网时长或话费等字段。查询他人手机号前须取得授权。

请求方式

请求地址https://sowk.xingsuqy.com/v1/query/mo-geo
请求方法POST
Content-Typeapplication/json
鉴权请求头 X-API-Key

请求参数

nametyperequireddesc
mobilestring是手机号码
languagestring否返回语言

返回参数

data 字段结构如下,外层为统一响应结构(见开发文档)。

nametypedesc
provincestring省份
citystring城市
operatorstring运营商

请求示例

curl -X POST https://sowk.xingsuqy.com/v1/query/mo-geo \
  -H "X-API-Key: xs_your_key" \
  -H "Content-Type: application/json" \
  -d '{"mobile":"138****0000","language":"zh-CN"}'

返回示例

以下为文档示例,不是本次实时查询结果。请勿把示例数据作为业务判断依据。

{
    "code": 0,
    "message": "success",
    "request_id": "20260919120000abc123",
    "data": {
        "province": "北京市",
        "city": "北京市",
        "operator": "示例值"
    }
}

错误码

codeHTTP说明处理建议
0200成功—
400400参数缺失或格式错误检查 message 指出的参数
401401API Key 缺失或无效在控制台核对 Key
1002402该接口无可用次数联系客服开通
1003403该接口未对当前账户开通联系客服开通
404404接口不存在核对接口编号
429429超出频率限制按 Retry-After 重试

计费说明

本页为接口参考报价。具体套餐、计费口径与开通范围请在申请时确认;提交申请不会扣费。

连接检查

可先检查本站网关是否可达。此检查不查询业务数据、不需要 API Key,也不代表已取得当前接口权限。

curl https://sowk.xingsuqy.com/v1/status

收到 code=0、service=xingsu 表示网关响应正常;正式查询请按上面的请求参数,在服务端使用自己的 API Key。