{ "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": "认证标示 \n0：认证成功\n1：认证失败\n2：无该手机号记录\n11：手机号、身份证或者姓名为空\n12：身份证校验错误\n13：手机号校验错误\n21：渠道升级暂停服务\n22：渠道维护暂停服务" }, "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": "认证标示 \n0：认证成功\n1：认证失败\n2：无该手机号记录\n11：手机号、身份证或者姓名为空\n12：身份证校验错误\n13：手机号校验错误\n21：渠道升级暂停服务\n22：渠道维护暂停服务" }, "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": "使用身份证、姓名、手机号校验信息是否真实匹配，支持移动、联通、电信、广电手机号。\n温馨提示：当请求参数存在明显错误时（比如手机号输入少了一位），同一个错误参数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": "认证标示 \n0：认证成功\n2：无该手机号记录\n3: 手机号已实名，但是身份证和姓名均与实名信息不一致\n4: 手机号已实名，手机号和身份证一致，姓名不一致\n5: 手机号已实名，手机号和姓名一致，身份证不一致\n11：手机号、身份证或者姓名为空\n12：身份证校验错误\n13：手机号校验错误\n21：渠道升级暂停服务\n22：渠道维护暂停服务" }, "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": "使用身份证、姓名、手机号校验信息是否真实匹配，支持移动、联通、电信、广电手机号。\n温馨提示：当请求参数存在明显错误时（比如手机号输入少了一位），同一个错误参数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": "认证标示 \n0：认证成功\n1：认证失败\n2：无该手机号记录\n11：手机号、身份证或者姓名为空\n12：身份证校验错误\n13：手机号校验错误\n21：渠道升级暂停服务\n22：渠道维护暂停服务" }, "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": true }