Loading repository data…
thdev-matheus / repository
este repositório é destinado ao backend da aplicação talks, que tem a intenção de ser um mini blog onde as pessoas podem postar o que desejam.
This API was structured with the aim of being the back-end part of the Talks application, a front-end project made by Matheus Vieira (Theus).
Talks is a social network based on posts, likes and comments. Therefore, the structure of this API is based on three main CRUD (Create-Read-Update-Delete):
Some other routes and entities were necessary, due to all the possible data and relationships of these three main entities like Likes and Notifications.
These were the main technologies used in this project:
Base URL: https://localhost:3001 mudar o link pelo amor de Deus
Some routes need authentication. The authentication used is the Bearer Token type.
The token is automatically generated upon user login.
Thus, to access routes with authentication, it is necessary to have a user and be logged in with the user.
Also, some routes require the user to be the owner of the post, comment, or like in order to make the request.
Read the documentation for each route to understand which authentications are required.
The User object is defined as:
| Field | Type | Description |
|---|---|---|
| id | string | User's unique identifier |
| firstName | string | User first name |
| lastName | string | User last name |
| string | User e-mail | |
| password | string | User password |
| birthdate | string | User's date of birth |
| isAdm | boolean | Defines whether a user is an administrator or not |
| isActive | boolean | Defines whether a user is active or not |
| isVerified | boolean | Defines if the user has verified the registered email or not |
| profileImage | string | User's profile photo file sent in the request |
| bio | string | A small user definition |
| createdAt | Date | User creation date |
| updatedAt | Date | User update date |
| Method | Route | Description |
|---|---|---|
| POST | /users | Creates a user |
| GET | /users | List all users |
| GET | /users/:userId | Lists a user using its ID as a parameter |
| PATCH | /users/validate | Update isVerified field to true |
| PATCH | /users/:userId | Updates a user using its ID as a parameter |
| DELETE | /users/:userId | Soft-deletes a user using its ID as a parameter |
Request body example
{
"firstName": "Ícarus",
"lastName": "Maximus",
"email": "max.icarus@gmail.com",
"password": "Icarus!1234",
"birthdate": "1991-06-28",
"bio": "Just a single guy"
}
Status 201 - Created
{
"id": "e14d80c9-a148-4208-8aa9-354a16da7852",
"firstName": "Ícarus",
"lastName": "Maximus",
"email": "max.icarus@gmail.com",
"bio": "Just a single guy",
"birthdate": "1991-06-28T00:00:00.000Z",
"profileImage": "https://i.ibb.co/hM0XsT4/21-214439-free-high-quality-person-icon-default-profile-picture.png",
"isAdm": false,
"createdAt": "2022-09-24T17:48:08.984Z",
"updatedAt": "2022-09-24T17:48:08.984Z",
"isActive": true,
"isVerified": false
}
Status 400 - Missing required field
{
"status": "Error",
"code": 400,
"message": "The bio field is mandatory",
"image": "https://http.cat/400"
}
Status 400 - Invalid data type or length
{
"status": "Error",
"code": 400,
"message": "yup error message",
"image": "https://http.cat/400"
}
Status 409 - Email already exists
{
"status": "Error",
"code": 409,
"message": "This email already exists",
"image": "https://http.cat/409"
}
Request headers
{
"authorization": "Bearer Token"
}
Status 200 - OK
[
{
"id": "e14d80c9-a148-4208-8aa9-354a16da7852",
"firstName": "Ícarus",
"lastName": "Maximus",
"email": "max.icarus@gmail.com",
"bio": "Just a single guy",
"birthdate": "1991-06-28T00:00:00.000Z",
"profileImage": "https://i.ibb.co/hM0XsT4/21-214439-free-high-quality-person-icon-default-profile-picture.png",
"isAdm": false,
"createdAt": "2022-09-24T17:48:08.984Z",
"updatedAt": "2022-09-24T17:48:08.984Z",
"isActive": true,
"isVerified": false
},
...
]
Status 401 - Missing authorization token
{
"status": "Error",
"code": 401,
"message": "Missing authorization token",
"image": "https://http.cat/401"
}
Status 401 - Invalid token
{
"status": "Error",
"code": 401,
"message": "Invalid token",
"image": "https://http.cat/401"
}
Request headers
{
"authorization": "Bearer Token"
}
Status 200 - OK
{
"id": "e14d80c9-a148-4208-8aa9-354a16da7852",
"firstName": "Ícarus",
"lastName": "Maximus",
"email": "max.icarus@gmail.com",
"bio": "Just a single guy",
"birthdate": "1991-06-28T00:00:00.000Z",
"profileImage": "https://i.ibb.co/hM0XsT4/21-214439-free-high-quality-person-icon-default-profile-picture.png",
"isAdm": false,
"createdAt": "2022-09-24T17:48:08.984Z",
"updatedAt": "2022-09-24T17:48:08.984Z",
"isActive": true,
"isVerified": false
}
Status 401 - Missing authorization token
{
"status": "Error",
"code": 401,
"message": "Missing authorization token",
"image": "https://http.cat/401"
}
Status 401 - Invalid token
{
"status": "Error",
"code": 401,
"message": "Invalid token",
"image": "https://http.cat/401"
}
Status 404 - User not found
{
"status": "Error",
"code": 404,
"message": "User not found",
"image": "https://http.cat/404"
}
Status 401 - Account is deactivated
{
"status": "Error",
"code": 401,
"message": "Account deleted, please contact customer service",
"image": "https://http.cat/401"
}
Request body example
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlbWFpbCI6Im1hdGhldXN0aC5kZXZAZ21haWwuY29tIiwiaWQiOiJlMTRkODBjOS1hMTQ4LTQyMDgtOGFhOS0zNTRhMTZkYTE0NTkiLCJpYXQiOjE2NjQwNDE2ODgsImV4cCI6MTY2NDIxNDQ4OH0.SMx0exifh8iAIufcBjYRO3FH8k7BE0W485PtklNopNh"
}
Status 202 - Accepted
{
"message": "Email successfully validated"
}
Status 401 - Missing token
{
"status": "Error",
"code": 401,
"message": "Token is missing",
"image": "https://http.cat/401"
}
Status 401 - Invalid token
{
"status": "Error",
"code": 401,
"message": "Invalid token",
"image": "https://http.cat/401"
}
Status 404 - E-mail not registered
{
"status": "Error",
"code": 404,
"message": "Email not registered in database",
"image": "https://http.cat/404"
}
Request headers
{
"authorization": "Bearer Token"
}
Request body example
{
"firstName": "Ikarus",
"oldPassword": "Icarus!1234"
}
Status 200 - OK
{
"id": "e14d80c9-a148-4208-8aa9-354a16da7852",
"firstName": "Ikarus",
"lastName": "Maximus",
"email": "max.icarus@gmail.com",
"bio": "Just a single guy",
"birthdate": "1991-06-28T00:00:00.000Z",
"profileImage": "https://i.ibb.co/hM0XsT4/21-214439-free-high-quality-person-icon-default-profile-picture.png",
"isAdm": false,
"createdAt": "2022-09-24T17:48:08.984Z",
"updatedAt": "2022-09-24T17:48:08.984Z",
"isActive": true,
"isVerified": false
}
Status 401 - Missing authorization token
{
"status": "Error",
"code": 401,
"message": "Missing authorization token",
"image": "https://http.cat/401"
}
Status 401 - Invalid token
{
"status": "Error",
"code": 401,
"message": "Invalid token",
"image": "https://http.cat/401"
}
Status 400 - Invalid data type or length
{
"status": "Error",
"code": 400,
"message": "yup error message",
"image": "https://http.cat/400"
}
Status 404 - User not found
{
"status": "Error",
"code": 404,
"message": "User not found",
"image": "https://http.cat/404"
}
Status 401 - Account is deactivated
{
"status": "Error",
"code": 401,
"message": "Inactive account",
"image": "https://http.cat/401"
}
Status 401 - Invalid password
{
"status": "Error",
"code": 401,
"message": "Incorrect password",
"image": "https://http.cat/401"
}
Selected from shared topics, language and repository description—not editorial ratings.
robertolima-dev /
Este repositório contém um projeto de aplicação Node Express usando Redis para cache. O objetivo deste projeto é criar uma aplicação web escalável e de alto desempenho usando Node Express e Redis. O código inclui exemplos de código Node Express para configurar o servidor, bem como documentação detalhada sobre como usar o Redis para cache.
JsCodeDevlopment /
Este repositório contém um microserviço desenvolvido em NestJS que encapsula toda a integração com a API do Asaas. O objetivo é fornecer, de forma centralizada e reutilizável por várias aplicações, funcionalidades de: Criação de clientes Geração de cobranças (boleto, cartão de crédito, PIX) Criação e consulta de links de pagamento etc...
PauloEduardoCruz /
Basketball Finder é um sistema para pessoas que gostam de jogar basquete encontrarem jogos próximos a ela. Este repositório é o protótipo da ideia, ele possui o front-end do projeto que foi desenvolvido com React, TypeScript, Open Street Map e Leaflet. Para fazer a persistência dos dados desenvolvi uma API usando Node, Express, Typeorm, Multer e Yup.
Leonardobern10 /
Este projeto é uma API desenvolvida em TypeScript usando Express.js para gerenciar informações relacionadas a clubes e jogadores de futebol. A API fornece endpoints para realizar operações CRUD (Create, Read, Update, Delete) em jogadores e clubes, utilizando serviços e repositórios para separar a lógica de negócio da interação com os dados.
crabominable /
Este repositório é uma API genérica que utiliza typescript, nodejs, express e o prisma ORM!
dhDSouza /
Este repositório contém uma API REST simples utilizando MySQL e TypeScript. Desenvolvida durante aula ministrada do curso desenvolvimento back-end com typescript.