added API readme file
This commit is contained in:
parent
135696eb2a
commit
0c84751943
154
API.md
Normal file
154
API.md
Normal file
@ -0,0 +1,154 @@
|
||||
# Routes
|
||||
|
||||
## POST /auth/register
|
||||
|
||||
Creates a new user.
|
||||
|
||||
### Request Body
|
||||
|
||||
The request body should be a JSON object with the following properties:
|
||||
|
||||
```json
|
||||
{
|
||||
"first_name": "Adham",
|
||||
"last_name": "Haddad",
|
||||
"username": "adhamhaddad",
|
||||
"email": "adhamhaddad.dev@gmail.com",
|
||||
"password": "secret-password"
|
||||
}
|
||||
```
|
||||
|
||||
### Response
|
||||
|
||||
If the user is successfully created, the server will respond with a status code of 201 and a JSON object representing the new user:
|
||||
|
||||
```json
|
||||
{
|
||||
"id": 1,
|
||||
"first_name": "Adham",
|
||||
"last_name": "Haddad",
|
||||
"username": "adhamhaddad",
|
||||
"email": "adhamhaddad.dev@gmail.com"
|
||||
}
|
||||
```
|
||||
|
||||
## POST /auth/login
|
||||
|
||||
Authenticate user.
|
||||
|
||||
### Request Body
|
||||
|
||||
The request body should be a JSON object with the following properties:
|
||||
|
||||
```json
|
||||
{
|
||||
"email": "adhamhaddad.dev@gmail.com",
|
||||
"password": "secret-password"
|
||||
}
|
||||
```
|
||||
|
||||
### Response
|
||||
|
||||
If the user is exists and authenticated successfully, the server will respond with a status code of 200 and a JSON object representing the authenticated user:
|
||||
|
||||
```json
|
||||
{
|
||||
"user": {
|
||||
"id": 1,
|
||||
"first_name": "Adham",
|
||||
"last_name": "Haddad",
|
||||
"username": "adhamhaddad",
|
||||
"email": "adhamhaddad.dev@gmail.com",
|
||||
},
|
||||
"accessToken": "<Access-Token>"
|
||||
}
|
||||
```
|
||||
|
||||
## POST /auth/refresh-token
|
||||
|
||||
Refresh the access and refresh tokens.
|
||||
|
||||
### Request Headers
|
||||
|
||||
The request headers should have a Cookies with the following properties:
|
||||
|
||||
```json
|
||||
refreshToken="<Refresh-Token>"
|
||||
```
|
||||
|
||||
### Response
|
||||
|
||||
If the refresh token is exists in redis and valid, the server will respond with a status code of 200 and a JSON object representing a new tokens:
|
||||
|
||||
```json
|
||||
{
|
||||
"accessToken": "<Access-Token>",
|
||||
}
|
||||
```
|
||||
|
||||
## GET /users/:userId
|
||||
|
||||
Get a user by id.
|
||||
|
||||
### Request Headers
|
||||
|
||||
The request headers should have a Cookies with the following properties:
|
||||
|
||||
```json
|
||||
accessToken="<Access-Token>"
|
||||
refreshToken="<Refresh-Token>"
|
||||
```
|
||||
|
||||
### Response
|
||||
|
||||
If the user is exists, the server will respond with a status code of 200 and a JSON object representing the received user:
|
||||
|
||||
```json
|
||||
{
|
||||
"id": 1,
|
||||
"first_name": "Adham",
|
||||
"last_name": "Haddad",
|
||||
"username": "adhamhaddad",
|
||||
"email": "adhamhaddad.dev@gmail.com"
|
||||
}
|
||||
```
|
||||
|
||||
## PATCH /users/:userId
|
||||
|
||||
Get a user by id.
|
||||
|
||||
### Request Headers
|
||||
|
||||
The request headers should have a Cookies with the following properties:
|
||||
|
||||
```json
|
||||
accessToken="<Access-Token>"
|
||||
refreshToken="<Refresh-Token>"
|
||||
```
|
||||
|
||||
### Request Body
|
||||
|
||||
The request body should be a JSON object with the following properties:
|
||||
|
||||
```json
|
||||
{
|
||||
"first_name": "Adham",
|
||||
"last_name": "Ashraf",
|
||||
"username": "adhamhaddad",
|
||||
"email": "adhamhaddad.dev@gmail.com"
|
||||
}
|
||||
```
|
||||
|
||||
### Response
|
||||
|
||||
If the user is exists and updated, the server will respond with a status code of 204 and a JSON object representing the received user:
|
||||
|
||||
```json
|
||||
{
|
||||
"id": 1,
|
||||
"first_name": "Adham",
|
||||
"last_name": "Ashraf",
|
||||
"username": "adhamhaddad",
|
||||
"email": "adhamhaddad.dev@gmail.com"
|
||||
}
|
||||
```
|
||||
@ -32,7 +32,6 @@ export const setAccessToken = async (payload: Payload): Promise<string> => {
|
||||
});
|
||||
return token;
|
||||
} catch (err) {
|
||||
console.log((err as Error).message);
|
||||
throw new Error('Failed to sign JWT');
|
||||
} finally {
|
||||
await redisClient.disconnect();
|
||||
|
||||
Loading…
Reference in New Issue
Block a user