Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/roman-koshchei/fit-knu-tournament

FIT KNU Tournament 2023 best project
https://github.com/roman-koshchei/fit-knu-tournament

api auth hackathon

Last synced: about 2 months ago
JSON representation

FIT KNU Tournament 2023 best project

Host: GitHub
URL: https://github.com/roman-koshchei/fit-knu-tournament
Owner: roman-koshchei
License: mit
Created: 2023-11-07T13:04:01.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-03-11T19:22:34.000Z (11 months ago)
Last Synced: 2024-03-11T20:37:38.621Z (11 months ago)
Topics: api, auth, hackathon
Language: C#
Homepage: https://fit-knu-tournament.onrender.com
Size: 1.77 MB
Stars: 0
Watchers: 1
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# QuasarSoft Auth

Authentication service made by QuasarSoft team for FIT KNU Tournament 2023

## API tasks

- [x] Registration: POST email + pasword + confirm password -> return token
- [x] Login: POST email + password -> return token
- [x] Check: GET token -> ok if token valid
- [x] ME: GET token -> email
- [x] Change password: POST token + old password + new password + change user version +1
- [x] Change email: POST token + email + change user version + 1
- [x] Delete user: DELETE token + password
- [x] Google

## UI tasks

- [x] Home/login form/page
- [x] Registartion page
- [x] Account info
- [x] Confirm account delete page
- [x] Change password page
- [x] Change email page
- [ ] Google

## API reference

To work with API you can look at:

- Swagger documentation on the [website](https://fit-knu-tournament.onrender.com/swagger)
- Markdown documentation [API reference](./docs/api.md)

## Registration

Endpoint: `POST /api/auth/register`

### Request
```
{
email: [email protected],
password: your_password,
confirmPassword: your_password
}
```

### Response
```
{
??
}
```

Posible status codes:
- 200 OK: Registration was successful.
- 400 Bad Request: Data is unvaliable.
- 500 Internal Server Error: Registration failed.

## Login

Endpoint: `POST /api/auth/login`

### Request
```
{
email: [email protected],
password: your_password
}
```

### Response
```
{
??
}
```

Possible status codes:
- 200 OK: Succesful login.
- 401 Unauthorized: Incorrect credentials

## Check

Endpoint: `GET /api/auth/check`

### Request

*Accepts no request, using the cookie header*

### Response
```
{
??
}
```

Possible status codes:
- 200 OK: Token is valid
- 401 Unauthorized: Token is invalid

## Me

Endpoint: `GET /api/account/me`

### Request:

*Accepts no request, using the cookie header*

### Response
```
{
??
}
```

Possible status codes:
- 200 OK: Token is valid, and user information returned.
- 401 Unauthorized: Token is invalid.

## Change Password

Endpoint: `PUT /api/account/password`

### Request
```
{
oldPassword: your_old_password,
newPassword: your_new_password
}
```

### Response
```
{

}
```

Possible status code:
- 200 OK: Successful password change.
- 401 Unauthorized: Invalid old password.

## Change Email

Endpoint: `PUT /api/account/email`

### Request
```
{
email: [email protected]
}
```

### Response
```
{
??
}
```

Possible status codes:
- 200 OK: Successful email change.
- 401 Unauthorized: Invalid token.

## Delete User

Endpoint: `DELETE /api/account`

### Request

*Accepts no request, using the cookie header*

### Response
```
{
??
}
```

Possible status codes:
- 200 OK: Successful user deletion.
- 401 Unauthorized: Invalid password.

## Google Auth

Endpoint: `POST /api/auth/google`

### Request
```
{
??
}
```

### Response
```
{
??
}
```

Possible status codes:
- 200 OK: Successful Google authentication
- 401 Unauthorized: Invalid Google access token