| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253 |
- # 由 openapi/scripts/generate.php 生成，请勿手改；补充写到 overrides/v3-email-certifications.yaml
- post:
- summary: 发送注册验证码
- tags:
- - email-certifications
- operationId: post_api_v3_email_certifications
- description: |-
- 向邮箱发一个 6 位验证码，30 分钟内有效；重复申请会作废上一个。
- 邮箱已注册时返回 422。按 IP 与邮箱限流，超出返回 429。
- 实现：`V3\EmailCertificationController@store`
- security:
- - { }
- -
- bearerAuth: []
- requestBody:
- required: true
- content:
- application/json:
- schema:
- type: object
- properties:
- email:
- type: string
- description: 待注册的邮箱
- example: someone@example.com
- lang:
- type: string
- description: '邮件语言，没有对应模板的回落 en'
- enum:
- - en
- - en-US
- - zh-Hans
- - zh-Hant
- required:
- - email
- responses:
- 204:
- description: 已发送，无响应体
- 422:
- $ref: '../../main.yaml#/components/responses/ProblemValidation'
- 429:
- description: 请求过于频繁
- content:
- application/problem+json:
- schema:
- $ref: '../../main.yaml#/components/schemas/ProblemDetails'
- 503:
- description: 邮件发送失败
- content:
- application/problem+json:
- schema:
- $ref: '../../main.yaml#/components/schemas/ProblemDetails'
|
