# Generated by ShowAPI OpenAPI generator # source: market/1389 # generated-at: 2026-07-26T02:02:01.997Z openapi: 3.0.3 info: title: 运营商手机号实名认证 description: 手机三要素认证—运营商三要素验证—手机号实名，支持移动/联通/电信/广电的四网手机号实名验证。通过校验身份证号、姓名、手机号三项信息是否匹配一致，一致会返回验证的手机归属地/运营商名称/籍贯/性别等信息。直连运营商，精准核验，数据无缓存，准确率高达99.99% termsOfService: https://www.showapi.com/helpcenter/view#/4019/2 version: 1.0.0 servers: - url: https://route.showapi.com paths: /1389-7: x-pointCode: 7 x-mode: mapping x-read-timeout: 15 x-connect-timeout: 15 post: summary: 运营商二要素_身份证_手机号 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: 调用业务成功表示，成功则扣费 order: type: string description: 渠道订单号 code: type: number description: |- 认证标示 0：认证成功 1：认证失败 2：无该手机号记录 11：手机号、身份证或者姓名为空 12：身份证校验错误 13：手机号校验错误 21：渠道升级暂停服务 22：渠道维护暂停服务 belongArea: type: object properties: num: type: number description: 号段 prov: type: string description: 省 name: type: string description: 运营商 provCode: type: string description: 省别编码，本省身份证的前几位编码。 type: type: number description: 1为移动 2为电信 3为联通 4为广电 city: type: string description: 市 description: 归属地信息 msg: type: string description: 认证结果提示信息 description: 业务返回体 operationId: 1389_7_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: phone: type: string description: 三网手机号 idCard: type: string description: 手机号实名对应的身份证号 needBelongArea: type: string description: 是否返回手机号归属地信息 required: - phone - idCard /1389-6: x-pointCode: 6 x-mode: mapping x-read-timeout: 15 x-connect-timeout: 15 post: summary: 运营商二要素_姓名_手机号 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: 调用业务成功表示，成功则扣费 order: type: string description: 渠道订单号 code: type: number description: |- 认证标示 0：认证成功 1：认证失败 2：无该手机号记录 11：手机号、身份证或者姓名为空 12：身份证校验错误 13：手机号校验错误 21：渠道升级暂停服务 22：渠道维护暂停服务 belongArea: type: object properties: num: type: number description: 号段 prov: type: string description: 省 name: type: string description: 运营商 provCode: type: string description: 省别编码，本省身份证的前几位编码。 type: type: number description: 1为移动 2为电信 3为联通 4为广电 city: type: string description: 市 description: 归属地信息 msg: type: string description: 认证结果提示信息 description: 业务返回体 operationId: 1389_6_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: name: type: string description: 手机号实名对应的姓名 phone: type: string description: 三网手机号 needBelongArea: type: string description: 是否返回手机号归属地信息 required: - name - phone /1389-5: x-pointCode: 5 x-mode: mapping x-read-timeout: 45 x-connect-timeout: 5 post: summary: 运营商三要素_详情版 description: |- 使用身份证、姓名、手机号校验信息是否真实匹配，支持移动、联通、电信、广电手机号。 温馨提示：当请求参数存在明显错误时（比如手机号输入少了一位），同一个错误参数24小时内调用超过10次我们将进行扣费。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: 调用业务成功表示，成功则扣费 code: type: number description: |- 认证标示 0：认证成功 2：无该手机号记录 3: 手机号已实名，但是身份证和姓名均与实名信息不一致 4: 手机号已实名，手机号和身份证一致，姓名不一致 5: 手机号已实名，手机号和姓名一致，身份证不一致 11：手机号、身份证或者姓名为空 12：身份证校验错误 13：手机号校验错误 21：渠道升级暂停服务 22：渠道维护暂停服务 msg: type: string description: 认证结果提示信息 belongArea: type: array items: type: object properties: prov: type: string description: 省 city: type: string description: 市 name: type: string description: 运营商 num: type: number description: 号段 provCode: type: number description: 省别编码，本省身份证的前几位编码。 type: type: number description: 1为移动 2为电信 3为联通 4为广电 description: 归属地信息 order: type: string description: 渠道订单号 description: 业务返回体 operationId: 1389_5_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: idCard: type: string description: 手机号实名对应的身份证号 name: type: string description: 手机号实名对应的姓名 phone: type: string description: 三网手机号 needBelongArea: type: string description: 是否返回手机号归属地信息 required: - idCard - name - phone /1389-1: x-pointCode: 1 x-mode: mapping x-read-timeout: 45 x-connect-timeout: 5 post: summary: 运营商三要素 description: |- 使用身份证、姓名、手机号校验信息是否真实匹配，支持移动、联通、电信、广电手机号。 温馨提示：当请求参数存在明显错误时（比如手机号输入少了一位），同一个错误参数24小时内调用超过10次我们将进行扣费。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: ret_code: type: number description: 调用业务成功表示，成功则扣费 code: type: number description: |- 认证标示 0：认证成功 1：认证失败 2：无该手机号记录 11：手机号、身份证或者姓名为空 12：身份证校验错误 13：手机号校验错误 21：渠道升级暂停服务 22：渠道维护暂停服务 msg: type: string description: 认证结果提示信息 belongArea: type: array items: type: object properties: prov: type: string description: 省 city: type: string description: 市 name: type: string description: 运营商 num: type: number description: 号段 provCode: type: number description: 省别编码，本省身份证的前几位编码。 type: type: number description: 1为移动 2为电信 3为联通 4为广电 description: 归属地信息 order: type: string description: 渠道订单号 description: 业务返回体 operationId: 1389_1_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: idCard: type: string description: 手机号实名对应的身份证号 name: type: string description: 手机号实名对应的姓名 phone: type: string description: 三网手机号 needBelongArea: type: string description: 是否返回手机号归属地信息 required: - idCard - name - phone components: securitySchemes: AppKeyAuth: type: apiKey in: query name: appKey description: 从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp schemas: ShowapiResEnvelope: type: object description: ShowAPI 统一返回包裹（业务数据位于 showapi_res_body） properties: showapi_res_code: type: integer description: API 返回的状态码 showapi_res_error: type: string description: API 返回的错误信息 showapi_res_id: type: string description: API 请求的唯一标识 showapi_fee_num: type: integer description: API 调用计费次数 security: - AppKeyAuth: [] externalDocs: url: https://www.showapi.com/apiGateway/view/1389?tab=book x-apiCode: "1389" x-is-own: false x-is-op: false