运营商三要素实名认证：接口指南总目录

# 运营商三要素实名认证：接口指南总目录 > **接口**：运营商三要素 - 运营商手机号实名认证 · **apiCode**：1389 · **接入点**：1个（1389-1） > **请求方式**：POST · **返回格式**：JSON · **计费**：按次（ret_code=0 时扣费，具体档位以官方说明为准） > **适用人群**：新注册用户、初级开发者、全栈工程师 > **阅读时间**：5 分钟 > **最后实测核对**：2026-09-07 --- ## 接口一句话速览 运营商三要素实名认证接口（showapi apiCode=1389）通过传入**姓名 + 身份证号 + 手机号**三个字段，一次性验证三者是否一致，并可选择返回手机号归属地信息（省、市、运营商、号段）。适用于用户注册实名校验、风控身份核验、账号安全加固等场景。 --- ## 系列文章索引 | # | 标题 | 链接 | 一句话简介 | |---|------|------|-----------| | 1 | 运营商三要素实名认证：5 分钟完成第一条实名校验 | [查看详情](https://www.showapi.com/guides/idcard-phone-auth-quickstart-1389) | 从注册到第一条成功调用，Python / cURL / Node.js 三语言代码 | | 2 | 运营商三要素实名认证：完整错误码对照表（code 0/1/2/11/12/13/21/22） | [查看详情](https://www.showapi.com/guides/idcard-phone-auth-response-codes-1389) | 8 项业务错误码完整枚举 + 归属地字段结构 | | 3 | 运营商三要素实名认证：注册实名校验集成方案 | [查看详情](https://www.showapi.com/guides/idcard-phone-auth-scenario-integration-1389) | 数据表设计、触发时机、失败流程、归属地展示 | | 4 | 运营商三要素实名认证：三要素 vs 二要素 vs 四要素方案对比 | [查看详情](https://www.showapi.com/guides/idcard-phone-auth-comparison-1389) | 三种核验方案中立对比，各方案适用场景与局限 | | 5 | 运营商三要素实名认证：按次计费下的缓存策略 | [查看详情](https://www.showapi.com/guides/idcard-phone-auth-cache-cost-1389) | 相同参数重复查询缓存逻辑，生产级 Redis 示例 | > 本系列共 **5 篇正文 + 1 篇索引页 = 6 篇**。 --- ## 建议阅读顺序 ``` 索引页（本文） └─► 快速开始（第 2 篇）—— 先跑通第一次调用 └─► 错误码对照表（第 3 篇）—— 遇到报错随时查 └─► 注册场景集成（第 4 篇）—— 了解业务层如何接入 └─► 方案对比（第 5 篇）—— 选型决策参考 └─► 缓存策略（第 6 篇）—— 规模化后的成本优化 ``` 技术受众可直接从「错误码对照表」或「方案对比」切入；非技术读者建议按顺序阅读。 --- ## 相关资源 | 资源 | 链接 | |------|------| | 接口详情页 | https://www.showapi.com/apiGateway/view/1389 | | OpenAPI YAML | https://www.showapi.com/openapi/market/1389.yaml | | OpenAPI JSON | https://www.showapi.com/openapi/market/1389.json | | AppKey 管理 | https://www.showapi.com/console#/myApp | | 多语言调用示例 | https://www.showapi.com/apitest/market/1389/1 | | MCP 服务配置 | 见快速开始文章 | --- ## 快速参数速览 | 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | idCard | String | 是 | 手机号实名对应的身份证号 | | name | String | 是 | 手机号实名对应的姓名 | | phone | String | 是 | 三网手机号 | | needBelongArea | String | 否 | 是否返回手机号归属地信息，默认 `true` | 完整参数与返回说明见各篇文章。 --- **- 本系列共 6 篇**：本篇即为索引页，其余 5 篇见上方索引表。