# Generated by ShowAPI OpenAPI generator
# source: market/1389
# generated-at: 2026-06-26T02:00:40.275Z
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: true
