# 由 openapi/scripts/generate.php 生成，请勿手改；补充写到 overrides/v2-email-certification-email-certification.yaml
get:
  summary: '获取单个 email-certification/{email_certification}'
  tags:
    - email-certification
  operationId: get_api_v2_email_certification_email_certification_
  description: |
    v3 没有对应端点：验证码改在服务端比对（`POST /v3/invites`），不再回传给前端。
    保留仅为 dashboard-v4 兼容，待 v4 下线后删除。

    已知问题（v2 冻结不修）：直接返回验证码，邮箱验证可被绕过。
  parameters:
    -
      name: email_certification
      in: path
      required: true
      schema:
        type: string
  responses:
    200:
      description: '成功。业务失败时 HTTP 仍可能为 200，以 ok 字段为准。'
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              message:
                type: string
              data:
                type: object
    401:
      $ref: '../../main.yaml#/components/responses/Unauthorized'
    422:
      $ref: '../../main.yaml#/components/responses/ValidationError'
  deprecated: true
put:
  summary: '更新 email-certification/{email_certification}'
  tags:
    - email-certification
  operationId: put_api_v2_email_certification_email_certification_
  description: 实现：`EmailCertificationController@update`
  parameters:
    -
      name: email_certification
      in: path
      required: true
      schema:
        type: string
  responses:
    200:
      description: '成功。业务失败时 HTTP 仍可能为 200，以 ok 字段为准。'
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              message:
                type: string
              data:
                type: object
    401:
      $ref: '../../main.yaml#/components/responses/Unauthorized'
    422:
      $ref: '../../main.yaml#/components/responses/ValidationError'
patch:
  summary: '更新 email-certification/{email_certification}'
  tags:
    - email-certification
  operationId: patch_api_v2_email_certification_email_certification_
  description: 实现：`EmailCertificationController@update`
  parameters:
    -
      name: email_certification
      in: path
      required: true
      schema:
        type: string
  responses:
    200:
      description: '成功。业务失败时 HTTP 仍可能为 200，以 ok 字段为准。'
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              message:
                type: string
              data:
                type: object
    401:
      $ref: '../../main.yaml#/components/responses/Unauthorized'
    422:
      $ref: '../../main.yaml#/components/responses/ValidationError'
delete:
  summary: '删除 email-certification/{email_certification}'
  tags:
    - email-certification
  operationId: delete_api_v2_email_certification_email_certification_
  description: 实现：`EmailCertificationController@destroy`
  parameters:
    -
      name: email_certification
      in: path
      required: true
      schema:
        type: string
  responses:
    200:
      description: '成功。业务失败时 HTTP 仍可能为 200，以 ok 字段为准。'
      content:
        application/json:
          schema:
            type: object
            properties:
              ok:
                type: boolean
              message:
                type: string
              data:
                type: object
    401:
      $ref: '../../main.yaml#/components/responses/Unauthorized'
    422:
      $ref: '../../main.yaml#/components/responses/ValidationError'