# Generated by ShowAPI OpenAPI generator
# source: market/1872
# generated-at: 2026-06-26T06:27:13.244Z
openapi: 3.0.3
info:
  title: 身份证OCR实名核验
  description: 能够自动识别并快速提取身份证图片中的所有关键信息，包括姓名、性别、民族、出生日期、住址、身份证号码、签发机关以及有效期限。接口还能实时联网进行信息核查，确保提取的数据与官方记录一致，能准确识别和校验URL网络图片或base64图片信息。
  termsOfService: https://www.showapi.com/helpcenter/view#/4019/2
  version: 1.0.0
servers:
  - url: https://route.showapi.com
paths:
  /1872-1:
    x-pointCode: 1
    x-mode: mapping
    x-read-timeout: 5
    x-connect-timeout: 5
    post:
      summary: 身份证ocr实名认证
      description: "上传图片的base64数据进行校验是否匹配，是否是真实\r

        图片请选择较为清晰的、无杂物、显示边框，识别成功率不能保证100%，请酌情使用"
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          ret_code:
                            type: string
                            description: 请填写参数描述
                          birthday:
                            type: string
                            description: 生日，格式为YYYY-MM-DD
                          sex:
                            type: string
                            description: 性别：M为男性，F为女性
                          idcard:
                            type: string
                            description: 被校验的身份证号
                          name:
                            type: string
                            description: 被校验的姓名
                          msg:
                            type: string
                            description: 返回描述
                          code:
                            type: string
                            description: 验证标示 0：匹配 1：身份证与姓名不匹配 2：无此身份证号码
                          race:
                            type: string
                            description: 民族
                          address:
                            type: string
                            description: 地址
                        description: 业务返回体
      operationId: 1872_1_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                image_base64:
                  type: string
                  minLength: 1
                  maxLength: 100000000
                  description: "base64编码的二进制图片数据 "
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/1872?tab=book
x-apiCode: "1872"
x-is-own: true
x-is-op: true
