63 lines
1.2 KiB
YAML
63 lines
1.2 KiB
YAML
|
swagger: "2.0"
|
||
|
|
info:
|
||
|
|
title: Auth API
|
||
|
|
version: 1.0.0
|
||
|
|
description: 用户认证接口
|
||
|
|
|
||
|
|
paths:
|
||
|
|
|
||
|
|
/api/auth/email/confirmation:
|
||
|
|
get:
|
||
|
|
summary: 邮箱确认
|
||
|
|
parameters:
|
||
|
|
- name: token
|
||
|
|
in: query
|
||
|
|
type: string
|
||
|
|
required: true
|
||
|
|
description: 操作token
|
||
|
|
responses:
|
||
|
|
200:
|
||
|
|
description: 确认成功
|
||
|
|
|
||
|
|
/api/auth/oauth2/register:
|
||
|
|
get:
|
||
|
|
summary: 邮箱注册
|
||
|
|
parameters:
|
||
|
|
- name: body
|
||
|
|
in: body
|
||
|
|
required: true
|
||
|
|
schema:
|
||
|
|
$ref: '#/definitions/EmailRegisterRequest'
|
||
|
|
responses:
|
||
|
|
200:
|
||
|
|
description: 注册成功
|
||
|
|
schema:
|
||
|
|
$ref: '#/definitions/AuthResponse'
|
||
|
|
|
||
|
|
definitions:
|
||
|
|
|
||
|
|
EmailRegisterRequest:
|
||
|
|
type: object
|
||
|
|
required:
|
||
|
|
- email
|
||
|
|
- wcid
|
||
|
|
- guest_id
|
||
|
|
- register_token
|
||
|
|
properties:
|
||
|
|
email:
|
||
|
|
type: string
|
||
|
|
wcid:
|
||
|
|
type: integer
|
||
|
|
format: uint64
|
||
|
|
guest_id:
|
||
|
|
type: integer
|
||
|
|
format: uint64
|
||
|
|
register_token:
|
||
|
|
type: string
|
||
|
|
|
||
|
|
AuthResponse:
|
||
|
|
type: object
|
||
|
|
properties:
|
||
|
|
token:
|
||
|
|
type: string
|
||
|
|
description: 注册登录生成的JWT token
|