手机号实名认证API开发全流程：从沙箱测试到灰度发布实战手册

在身份验证和信息核验场景中，确保用户身份的真实性和合法性至关重要。**万维易源提供的“三网（广电）手机号实名认证”API为企业和开发者提供了一个高效、安全的工具，用于验证手机号、身份证号和姓名是否真实匹配。**本文将详细介绍如何使用该API，以及其核心功能和调用方法。

一、API概述

1. 接入点说明

**该API支持使用身份证、姓名和手机号校验信息是否真实匹配，支持移动、联通、电信、广电手机号。**广泛应用于信贷、安防、银行、保险等行业及各种身份核查场景。API直连官方数据源，提供实时核验，毫秒级响应，确保数据的准确性和时效性。

2. 注意事项

• 错误参数：当请求参数存在明显错误（比如手机号输入少了一位），同一个错误参数24小时内调用超过10次，将进行扣费。

3. 接口地址

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

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

二、请求参数

以下是提交三网手机号实名认证任务所需的请求参数：

参数名称	类型	示例值	必须	描述
idCard	String	（身份证号）	是	手机号实名对应的身份证号。
name	String	（姓名）	是	手机号实名对应的姓名。
phone	String	（手机号）	是	三网手机号。
needBelongArea	String	true	否	是否返回手机号归属地信息。

三、返回参数

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

参数名称	类型	示例值	描述
ret_code	Number	0	调用业务成功表示，成功则扣费。
code	Number	0	认证标示： 0：认证成功 1：认证失败 2：无该手机号记录 11：手机号、身份证或者姓名为空 12：身份证校验错误 13：手机号校验错误 21：渠道升级暂停服务 22：渠道维护暂停服务
msg	String	认证成功	认证结果提示信息。
belongArea	Object	（归属地信息）	归属地信息。
- prov	String	山西	省。
- city	String	临汾市	市。
- name	String	移动神州行卡	运营商。
- num	Number	1362068	号段。
- provCode	Number	140000	省别编码，本省身份证的前几位编码。
- type	Number	1	运营商类型： 1 为移动 2 为电信 3 为联通
order	String	6ddaf1ec67a343dc814c833ff0ae855f	渠道订单号。

四、调用示例

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

curl 'https://route.showapi.com/1389-1?appKey=your_appKey' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'needBelongArea=true' \
  -d 'name=' \
  -d 'phone=' \
  -d 'idCard='

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

五、返回示例

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

{
    "showapi_res_error": "",
    "showapi_res_code": 0,
    "showapi_res_id": "60740ce48d57ba8f1c10fb44",
    "showapi_res_body": {
        "ret_code": 0,
        "order": "6ddaf1ec67a343dc814c833ff0ae855f",
        "code": 0,
        "belongArea": {
            "num": 1362068,
            "prov": "山西",
            "name": "移动神州行卡",
            "provCode": "140000",
            "type": 1,
            "city": "临汾市"
        },
        "msg": "认证成功"
    }
}

六、获取 appKey

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

七、总结

万维易源的“三网手机号实名认证”API为企业和开发者提供了一个高效、安全的工具，用于验证手机号、身份证号和姓名是否真实匹配。通过简单的接口调用，可以快速获取认证结果和手机号的归属地信息。希望本文能帮助你更好地了解和使用该API。如果你有任何问题或需要进一步的帮助，请随时访问万维易源的官方文档或联系技术支持。