112 lines
No EOL
3 KiB
YAML
112 lines
No EOL
3 KiB
YAML
openapi: 3.1.0
|
|
info:
|
|
title: Auth Service
|
|
version: 1.0.0
|
|
|
|
paths:
|
|
/auth/sign-up:
|
|
post:
|
|
summary: Sign up a new user
|
|
tags: [Auth]
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
required: [nickname, pass]
|
|
properties:
|
|
nickname:
|
|
type: string
|
|
pass:
|
|
type: string
|
|
format: password
|
|
responses:
|
|
"200":
|
|
description: Sign-up result
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
success:
|
|
type: boolean
|
|
error:
|
|
type: string
|
|
nullable: true
|
|
user_id:
|
|
type: string
|
|
nullable: true
|
|
|
|
/auth/sign-in:
|
|
post:
|
|
summary: Sign in a user and return JWT
|
|
tags: [Auth]
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
required: [nickname, pass]
|
|
properties:
|
|
nickname:
|
|
type: string
|
|
pass:
|
|
type: string
|
|
format: password
|
|
responses:
|
|
"200":
|
|
description: Sign-in result with JWT
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
success:
|
|
type: boolean
|
|
error:
|
|
type: string
|
|
nullable: true
|
|
user_id:
|
|
type: string
|
|
nullable: true
|
|
token:
|
|
type: string
|
|
description: JWT token to access protected endpoints
|
|
nullable: true
|
|
|
|
/auth/verify-token:
|
|
post:
|
|
summary: Verify JWT validity
|
|
tags: [Auth]
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
required: [token]
|
|
properties:
|
|
token:
|
|
type: string
|
|
description: JWT token to validate
|
|
responses:
|
|
"200":
|
|
description: Token validation result
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
valid:
|
|
type: boolean
|
|
description: True if token is valid
|
|
user_id:
|
|
type: string
|
|
nullable: true
|
|
description: User ID extracted from token if valid
|
|
error:
|
|
type: string
|
|
nullable: true
|
|
description: Error message if token is invalid |