[DEMO] 手机归属地查询

查询国内手机号段的省市、运营商、区号和邮编

使用国内手机号段归属资料，不提供实名、骚扰标记、设备位置或实时运营商识别。保留既有 11 位号码输入和七个结果字段。库内未收录号段保留历史字符串 "null" 等空值形态，并返回 DataTotalCount=0；库文件不可用与合法未命中区分。UserTag 当前未提供标签数据，保持 null。携号转网后的当前运营商可能不同于库内号段归属，不应据此作身份或精确位置判断。

业务说明

使用国内 11 位手机号码查询号段归属资料。

返回号段所属省份，便于补充地区资料。

返回号段所属城市，便于城市分组展示。

返回号段归属运营商名称，便于号码资料整理。

保留来源中的虚拟运营商分类，便于区分类别。

返回可用长途区号，便于关联地区信息。

返回可用邮政编码，便于补充地区基础资料。

保留实际查询号码，便于将结果与输入对应。

对未收录号段提供明确的未命中计数。

可用于客服号码资料的地区辅助展示。

可用于获授权号码集合的省市分组整理，不代表用户实时位置。

返回字段

字段	类型	必返	可为 null	说明
DataStatus.RequestParameter	string	是	否	本次真实、可读的业务请求参数，不含凭据；Demo 与实际示例输入对应。
DataStatus.StatusCode	integer	是	否	100 成功；501 参数错误对应 HTTP 400；901 处理或依赖失败对应 HTTP 503，公共鉴权和限流规则保持。
DataStatus.StatusDescription	string	是	否	业务处理结果说明。
DataStatus.ResponseDateTime	string	是	否	响应生成时间，不代表资料公布、行情交易或净值日期。
DataStatus.DataTotalCount	integer	是	否	本次实际返回记录数量；技术资讯为本页文章数，未命中归属资料时为 0。
Data	object	是	否	号段归属结果对象；未命中时保留对象及历史空值表达，DataTotalCount=0。
Data.MobileNumber	string	是	否	本次查询的原始号码。
Data.Province	string / null	是	是	号段所属省份；未知号段保留历史 "null" 字符串。
Data.City	string / null	是	是	号段所属城市；未知号段保留历史 "null" 字符串。
Data.Operator	string / null	是	是	号段归属运营商；不保证是携号转网后的当前运营商。
Data.AreaCode	string / null	是	是	地区长途区号；可能为空或历史 "null" 字符串。
Data.ZipCode	string / null	是	是	地区邮政编码；可能为空或历史 "null" 字符串。
Data.UserTag	string / null	是	是	现有字段保留，当前没有标签数据，值为 null。

业务状态与 HTTP 状态

业务码	含义	HTTP 与处理说明
100	请求成功	HTTP 200；请同时检查业务状态与返回数据。
501	参数错误	HTTP 400；参数缺失、类型错误或参数冲突。
502	请求频率限制	HTTP 429，沿用公共限流契约。
503	权益过期	HTTP 403，沿用公共权益契约。
504	凭据或权限错误	结合 HTTP 状态区分凭据缺失、无效、无商品权限或鉴权服务不可用。
505	调用额度不足	HTTP 403，沿用公共额度契约。
901	处理或依赖失败	HTTP 503；包含目标处理失败、依赖失败和超时。

接口详情：https://www.gugudata.com/api/details/mobileattribution
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

返回响应

🟢200成功

application/json

成功，业务码 100。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"mobile=13022142605","StatusCode":100,"StatusDescription":"请求成功。","ResponseDateTime":"2026-10-31 14:58:43.760","DataTotalCount":1},"Data":{"MobileNumber":"13022142605","Province":"上海","City":"上海","Operator":"中国联通","AreaCode":"021","ZipCode":"200000","UserTag":null}}

🟠400参数缺失、非法、重复或冲突，业务码 501。

🔴503处理、依赖失败或超时，业务码 901。

业务说明#

返回字段#

业务状态与 HTTP 状态#

请求参数

请求示例代码

返回响应

业务说明

返回字段

业务状态与 HTTP 状态