手机号归属地查询API接入全解析：从免费接口到高精度商业方案对比

在开发和数据处理过程中，获取手机号码的归属地信息是一个常见的需求。**万维易源提供的“手机号码归属地查询”API为开发者提供了一个高效、便捷的工具，可以通过简单的接口调用查询手机号码的归属地信息。**本文将详细介绍如何使用该API，以及其核心功能和调用方法。

一、API概述

1. 接入点说明

该API支持查询手机号对应的归属地信息，返回的包括省、市、邮编、区号等详细信息。广泛应用于用户信息管理、市场分析、客户服务等场景。

2. 接口地址

https://route.showapi.com/6-1?appKey={your_appKey}

请将 {your_appKey} 替换为你在万维易源平台申请的个人 appKey。

二、请求参数

以下是提交手机归属地查询任务所需的请求参数：

参数名称	类型	示例值	必须	描述
num	String	18908711111	是	要查询的手机号码。

三、返回参数

以下是接口返回的参数及其描述：

参数名称	类型	示例值	描述
prov	String	云南	省。
city	String	昆明	市。
name	String	电信	运营商。
num	Number	1890871	号段。
provCode	Number	530000	省别编码，本省身份证的前几位编码。
type	Number	2	运营商类型： 1 为移动 2 为电信 3 为联通 4 为广电 -1 为未知
cityCode	String	530100	城市编码，本城市身份证的前几位编码。
ret_code	String	0	返回码： 0 为成功 其他值为失败。失败时不扣点数。 -2 表示手机号输入的不是11位 -3 表示手机号中有非数字字符 -4 表示手机号格式错误 -5 和 -6 表示找不到归属地
areaCode	String	0871	城市区号，座机号码前几位。
postCode	String	650000	邮编。

四、调用示例

以下是一个使用 curl 命令调用该接口的示例：

curl \
  -X POST 'https://route.showapi.com/6-1?appKey=your_appKey&num=18908711111' \
  -H 'Content-Type: application/x-www-form-urlencoded'

请将 your_appKey 替换为你在万维易源平台申请的 appKey。

五、返回示例

以下是接口返回的JSON示例：

{
  "showapi_res_code": 0,
  "showapi_res_error": "",
  "showapi_res_id": "ce135f6739294c63be0c021b76b6fbff",
  "showapi_res_body": {
    "num": 1890871,
    "prov": "云南",
    "ret_code": 0,
    "areaCode": "0871",
    "name": "电信",
    "cityCode": "530100",
    "postCode": "650000",
    "provCode": "530000",
    "type": 2,
    "city": "昆明"
  }
}

六、获取 appKey

要获取 appKey，请访问万维易源的控制台页面：
查看 appKey

七、总结

万维易源的“手机归属地查询”API为开发者提供了一个高效、便捷的工具，可以通过简单的接口调用查询手机号码的归属地信息。通过简单的接口调用，可以快速获取手机号码的详细归属地信息，包括省、市、邮编、区号等。希望本文能帮助你更好地了解和使用该API。如果你有任何问题或需要进一步的帮助，请随时访问万维易源的官方文档或联系技术支持。