| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879 |
- # 由 openapi/scripts/generate.php 生成，请勿手改；补充写到 overrides/v3-invites.yaml
- post:
- summary: 用验证码换注册邀请
- tags:
- - invites
- operationId: post_api_v3_invites
- description: |-
- 验证码正确则返回该邮箱的 invite（已有则复用，状态重置为未使用），验证码随即作废。
- 验证码错误、过期或试错 5 次后返回 422（errors.code）。
- 实现：`V3\InviteController@store`
- security:
- - { }
- -
- bearerAuth: []
- requestBody:
- required: true
- content:
- application/json:
- schema:
- type: object
- properties:
- email:
- type: string
- description: 收到验证码的邮箱
- code:
- type: string
- description: '邮件里的 6 位验证码'
- example: '123456'
- required:
- - email
- - code
- responses:
- 200:
- description: 成功
- content:
- application/json:
- schema:
- type: object
- properties:
- data:
- type: object
- properties:
- id:
- type: string
- email:
- type: string
- status:
- type: string
- created_at:
- type: string
- nullable: true
- 201:
- description: '首次为该邮箱签发 invite。响应体与 200 同形；复用已有 invite 时是 200'
- content:
- application/json:
- schema:
- type: object
- properties:
- data:
- type: object
- properties:
- id:
- type: string
- email:
- type: string
- status:
- type: string
- created_at:
- type: string
- nullable: true
- 422:
- $ref: '../../main.yaml#/components/responses/ProblemValidation'
- 429:
- description: 请求过于频繁
- content:
- application/problem+json:
- schema:
- $ref: '../../main.yaml#/components/schemas/ProblemDetails'
|
