Auth

APIs for authentication

Sign In

POST

http://localhost:7002/api/auth/signin

Issue access token and refresh token
* Currently, the api is using http and it does have vulnerability of sending plain password, but it will soon be updated to https.
* access tokens will be expired 10 minutes after they are issued.
* refresh tokens will be expired 2 weeks after they are issued.
Request
Response

Body Parameters

Field Type Description

id

required

string

ID

pw

required

string

(plain) password

Success

200 : Success


                                
                            

Fail

400 : Bad Request

- Either one of id or pw is not included in the request.
- id is not registered.
- id and pw are not matching.

ID Duplication Check

GET

http://localhost:7002/api/auth/id-duplicate-check

Checks if new id is duplicated or not
Request
Response

Query Parameters

Field Type Description

id

required

string

ID

Success

200 : Success

id is not duplicated(good to use)

Fail

400 : Bad Request

id is duplicated(not good to use)

Sign Up

POST

http://localhost:7002/api/auth/signup

Create a new account.
Request
Response

Body Parameters

Field Type Description

id

required

string

ID

pw

required

string

(plain) Password

nickname

required

string

Nickname

email

required

string

Email

age

required

int

Age

Success

200 : Success

New account has been successfully created.

Fail

400 : Bad Request

- Either one of id, pw, nickname, email or age is not included in the request or not a proper type.
- id already registered(duplicated id)

Refresh Token

GET

http://localhost:7002/api/auth/refresh

Re-issue an access token with refresh token
Request
Response

Headers

Field Type Description

x-access-token

required

string

(expired) access token

x-refresh-token

required

string

refresh token

Success

200 : Success


                                
                            

Fail

401 : Unauthorized

- x-access-token or x-refresh-token is not provided.
- x-access-token or x-refresh-token is not valid(not issued by the server, or modified).
- x-refresh-token is banned.
- x-access-token and x-refresh-token are not matching.