KenzieLog

A nossa API é projetada especificamente para gerenciamento logístico, permitindo aos usuários cadastrar suas informações e realizar todo o gerenciamento de suas compras e entregas. Com ela, os usuários podem facilmente acompanhar o status de suas entregas, agendar novas entregas e gerenciar seus pedidos de compra.

Documentação da API

Tabela de Conteúdos

• Visão Geral
• Diagrama ER
• Início Rápido
  • Instalando Dependências
  • Variáveis de Ambiente
  • Migrations
• Autenticação
• Endpoints

---

1. Visão Geral

Tecnologias utilizadas no projeto:

• NodeJS
• Express
• TypeScript
• PostgreSQL
• TypeORM
• Yup
• Bcrypt
• JsonWebToken
• DotEnv
• Jest

URL base da aplicação: https://kenzie-log.onrender.com

---

2. Diagrama ER

Voltar para o topo

Diagrama ER da API definindo bem as relações entre as tabelas do banco de dados.

---

3. Início Rápido

Voltar para o topo

3.1. Instalando Dependências

Clone o projeto em sua máquina e instale as dependências com o comando:

yarn

3.2. Variáveis de Ambiente

Em seguida, crie um arquivo .env, copiando o formato do arquivo .env.example:

cp .env.example .env

Configure suas variáveis de ambiente com suas credenciais do Postgres e uma nova database da sua escolha.

3.3. Migrations

Execute as migrations com o comando:

yarn typeorm migration:run -d src/data-source.ts

---

4. Autenticação

Voltar para o topo

Por enquanto, não foi implementada autenticação.

---

5. Endpoints

Voltar para o topo

Índice

• Users
  • POST - /users
  • GET - /users
  • GET - /users/:user_id
  • PATCH - /users/:user_id
  • DELETE - /users/:user_id
• Requests
  • POST - /requests
  • GET - /requests
  • GET - /requests/:request_id
  • GET - /requests/user/:user_id
  • PATCH - /requests
  • DELETE - /requests
• Login
  • POST - /login
• Company
  • POST - /company
  • GET - /company
  • GET - /company/:company_id
  • PATCH - /company/:company_id
  • DELETE - /company/:company_id
• Vehicles
  • POST - vehicles/company/:company_id
  • GET - vehicles/company/:company_id
  • DELETE - vehicles/:vehicle_id

---

1. Users

Voltar para os Endpoints

O objeto User é definido como:

Campo	Tipo	Descrição
id	string	Identificador único do usuário
name	string	O nome do usuário.
email	string	O e-mail do usuário.
password	string	A senha de acesso do usuário
isAdm	boolean	Define se um usuário é administrador ou não.
isActive	boolean	Define se um usuário está ativo ou não.
createdAt	Date	Data de criação do usuário.
updatedAt	Date	Data de atualização do usuário.
Address	Object	Informações do endereço do usuário.

Endpoints

Método	Rota	Descrição
POST	/users	Criação de um usuário.
GET	/users	Lista todos os usuários
GET	/users/:user_id	Lista um usuário por ID
PATCH	/users/:user_id	Edita Informações de um usuário por ID
DELETE	/users/:user_id	Deleta um usuário por ID

---

1.1. Criação de Usuário

Voltar para os Endpoints

/users

Exemplo de Request:

POST /users
Host: https://kenzielogapi.onrender.com
Authorization: None
Content-type: application/json

Corpo da Requisição:

{
  "name": "Marcio",
  "email": "[email protected]",
  "isAdm": true,
  "password": "123456",
  "address": {
    "district": "Rua Santa Ana",
    "zipCode": "26054188",
    "number": "21",
    "city": "Rio de Janeiro",
    "state": "RJ",
  },
}

Schema de Validação com Yup:

  name: yup.string().required().max(72),
  email: yup.string().email().required().max(256),
  password: yup.string().required().max(65),
  isAdm: yup.boolean().required(),
  address: yup.object({
    district: yup.string().required(),
    zipCode: yup.string().required().max(8),
    number: yup.string().notRequired(),
    city: yup.string().required(),
    state: yup.string().required().max(2),
  }),

OBS.: Chaves não presentes no schema serão removidas.

Exemplo de Response:

201 Created

{
  "id": "6baa58b7-1bdd-42aa-bb5c-4f89377e153e",
  "name": "Marcio",
  "email": "[email protected]",
  "isAdm": true,
  "isActive": true,
  "createdAt": "16/01/2023"
  "updatedAt": "16/01/2023"
  "address": {
    "id": "f0d55281-8ac8-4bc0-b5d0-78ab521e1f93"
    "district": "Rua Santa Ana",
    "zipCode": "26054188",
    "number": "21",
    "city": "Rio de Janeiro",
    "state": "RJ",
  },
}

Possíveis Erros:

Código do Erro	Descrição
409 Conflict	Email already registered.
400 Bad Requiest	Missing fields.

---

1.2. Listando Usuários

Voltar para os Endpoints

/users

Exemplo de Request:

GET /users
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin
Content-type: application/json

Corpo da Requisição:

Vazio

Exemplo de Response:

200 OK

[
  {
    "id": "6baa58b7-1bdd-42aa-bb5c-4f89377e153e",
    "name": "Marcio",
    "email": "[email protected]",
    "isAdm": true,
    "isActive": true,
    "createdAt": "16/01/2023",
    "updatedAt": "16/01/2023",
    "addressId": "f0d55281-8ac8-4bc0-b5d0-78ab521e1f93"
  }
]

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Invalid bearer token.
401 Unauthorized	Bad Request.

---

1.3. Listando Usuários por ID

Voltar para os Endpoints

/users/:user_id

Exemplo de Request:

GET /users/6baa58b7-1bdd-42aa-bb5c-4f89377e153e
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
user_id	string	Identificador único do usuário (User)

Corpo da Requisição:

Vazio

Exemplo de Response:

200 OK

{
  "id": "6baa58b7-1bdd-42aa-bb5c-4f89377e153e",
  "name": "Marcio",
  "email": "[email protected]",
  "isAdm": true,
  "isActive": true,
  "createdAt": "16/01/2023",
  "updatedAt": "16/01/2023",
  "addressId": "f0d55281-8ac8-4bc0-b5d0-78ab521e1f93"
}

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Invalid bearer token.
404 Not found	User not found.

---

1.4. Editando Usuários por ID

Voltar para os Endpoints

/users/:user_id

Exemplo de Request:

PATCH /users/6baa58b7-1bdd-42aa-bb5c-4f89377e153e
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin / User
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
user_id	string	Identificador único do usuário (User)

Corpo da Requisição:

{
  "email": "[email protected]"
}

Exemplo de Response:

200 OK

{
  "id": "6baa58b7-1bdd-42aa-bb5c-4f89377e153e",
  "name": "Marcio",
  "email": "[email protected]",
  "isAdm": true,
  "isActive": true,
  "createdAt": "16/01/2023",
  "updatedAt": "16/01/2023",
  "addressId": "f0d55281-8ac8-4bc0-b5d0-78ab521e1f93"
}

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Invalid bearer token.
403 Forbidden	Unauthorized.
401 Unauthorized	User not found.

---

1.5. Deletando Usuários por ID

Voltar para os Endpoints

/users/:user_id

Exemplo de Request:

DELETE /users/6baa58b7-1bdd-42aa-bb5c-4f89377e153e
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin / User
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
user_id	string	Identificador único do usuário (User)

Corpo da Requisição:

Vazio

Exemplo de Response:

204 No Content

Vazio

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Invalid bearer token.
404 Not found	User not found.

---

2. Requests

Voltar para os Endpoints

O objeto Request é definido como:

Campo	Tipo	Descrição
id	string	Identificador único do usuário
name	string	O nome do usuário.
status	string	O e-mail do usuário.
weight	number	A senha de acesso do usuário
cubicMeters	number	Define se um usuário é administrador ou não.
deadline	Date	Define se um usuário está ativo ou não.
createdAt	Date	Data de criação do usuário.
updatedAt	Date	Data de atualização do usuário.

Endpoints

Método	Rota	Descrição
POST	/requests	Criação de um pedido.
GET	/requests	Lista todos os pedidos.
GET	/requests/user/:user_id	Lista todos os pedidos de um usuário por ID
GET	/requests/:request_id	Lista um pedido por ID
PATCH	/requests/:request_id	Edita um pedido por ID
DELETE	/requests/:request_id	Deleta um pedido por ID

---

2.1. Criação de pedidos

Voltar para os Endpoints

/requests

Exemplo de Request:

POST /requests
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token
Content-type: application/json

Corpo da Requisição:

{
  "userId": "6baa58b7-1bdd-42aa-bb5c-4f89377e153e",
  "name": "Package Name",
  "weight": 80,
  "cubicMeters": 3,
  "distance": 128
}

Schema de Validação com Yup:

  name: yup.string(),
  status: yup.string(),
  deadline: yup.string(),
  weight: yup.number(),
  cubicMeters: yup.number()

OBS.: Chaves não presentes no schema serão removidas.

Exemplo de Response:

201 Created

{
  "id": "894c3b8e-4a32-4398-8c37-36c4d75f66c1",
  "name": "Package Name",
  "weight": 80,
  "cubicMeters": 3,
  "deadline": "27/02/2023"
  "createdAt": "16/02/2023"
  "updatedAt": "16/02/2023"
  "user": {
    "name": "Marcio",
    "email": "[email protected]",
    "isAdm": true,
    "password": "123456",
    "address": {
      "district": "Rua Santa Ana",
      "zipCode": "26054188",
      "number": "21",
      "city": "Rio de Janeiro",
      "state": "RJ",
    },
  }
}

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Invalid token.
409 Conflict	Request already exists.
404 Not Found	User not exists.

---

2.2. Listando Pedidos

Voltar para os Endpoints

/requests

Exemplo de Request:

GET /requests
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin
Content-type: application/json

Corpo da Requisição:

Vazio

Exemplo de Response:

200 OK

[
  {
    "id": "894c3b8e-4a32-4398-8c37-36c4d75f66c1",
    "name": "Package name",
    "status": "pending",
    "weight": 80,
    "cubicMeters": 3,
    "deadline": "27/02/2023",
    "createdAt": "16/02/2023",
    "updatedAt": "16/02/2023",
    "userId": "6baa58b7-1bdd-42aa-bb5c-4f89377e153e"
  }
]

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Invalid bearer token.
401 Unauthorized	Not authorized.

---

2.3. Listando pedidos por ID

Voltar para os Endpoints

/requests/:request_id

Exemplo de Request:

GET /requests/894c3b8e-4a32-4398-8c37-36c4d75f66c1
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
request_id	string	Identificador único do pedido (Request)

Corpo da Requisição:

Vazio

Exemplo de Response:

200 OK

{
  "id": "894c3b8e-4a32-4398-8c37-36c4d75f66c1",
  "name": "Package name",
  "status": "pending",
  "weight": 80,
  "cubicMeters": 3,
  "deadline": "27/02/2023",
  "createdAt": "16/02/2023",
  "updatedAt": "16/02/2023",
  "userId": "6baa58b7-1bdd-42aa-bb5c-4f89377e153e"
}

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Invalid bearer token.
404 Not found	Request not found.

---

2.4. Listando pedidos por ID de usuário

Voltar para os Endpoints

/requests/user/:user_id

Exemplo de Request:

GET /requests/user/6baa58b7-1bdd-42aa-bb5c-4f89377e153e
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
user_id	string	Identificador único do usuário (User)

Corpo da Requisição:

Vazio

Exemplo de Response:

200 OK

[
  {
    "id": "894c3b8e-4a32-4398-8c37-36c4d75f66c1",
    "name": "Package name",
    "status": "pending",
    "weight": 80,
    "cubicMeters": 3,
    "deadline": "27/02/2023",
    "createdAt": "16/02/2023",
    "updatedAt": "16/02/2023"
  }
]

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Invalid bearer token.
403 Forbidden	Unauthorized.
401 Unauthorized	User not found.

---

2.5. Editando Pedidos

Voltar para os Endpoints

/requests/:request_id

Exemplo de Request:

PATCH /requests/894c3b8e-4a32-4398-8c37-36c4d75f66c1
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin / User
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
request_id	string	Identificador único do pedido (Request)

Corpo da Requisição:

{
  "status": "delivered"
}

Exemplo de Response:

200 OK

{
  "id": "894c3b8e-4a32-4398-8c37-36c4d75f66c1",
  "name": "Package name",
  "status": "delivered",
  "weight": 80,
  "cubicMeters": 3,
  "deadline": "27/02/2023",
  "createdAt": "16/02/2023",
  "updatedAt": "16/02/2023",
  "userId": "6baa58b7-1bdd-42aa-bb5c-4f89377e153e"
}

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Invalid bearer token / Not authorization.
404 Not Found	Request not found.

---

2.6. Deletando Pedidos

Voltar para os Endpoints

/requests/:request_id

Exemplo de Request:

DELETE /requests/894c3b8e-4a32-4398-8c37-36c4d75f66c1
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin / User
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
request_id	string	Identificador único do pedido (Request)

Corpo da Requisição:

Vazio

Exemplo de Response:

204 No Content

Vazio

Possíveis Erros:

Código do Erro	Descrição
404 Not found	Request not found.
400 Bad request	Request already delete.

---

3. Login

Voltar para os Endpoints

O objeto Login é definido como:

Campo	Tipo	Descrição
email	string	O e-mail do usuário.
password	string	A senha de acesso do usuário

Endpoints

Método	Rota	Descrição
POST	/login	Login de um usuário.

---

3.1. Login de usuário

Voltar para os Endpoints

/login

Exemplo de Request:

POST /login
Host: https://kenzielogapi.onrender.com
Authorization: None
Content-type: application/json

Corpo da Requisição:

{
  "email":"[email protected]"
  "password":"123456"
}

Exemplo de Response:

200 Ok

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}

Possíveis Erros:

Código do Erro	Descrição
403 Forbidden	Wrong email/password.
400 Bad Request	User not found.

---

4. Company

Voltar para os Endpoints

O objeto Company é definido como:

Campo	Tipo	Descrição
id	string	Identificador único da unidade.
name	string	O nome da unidade.
openingTime	string	Horário de abertura da unidade.
cnpj	string	Cnpj da unidade.
isActive	boolean	Define se uma unidade está ativa ou não.
createdAt	Date	Data de criação da unidade.
updatedAt	Date	Data de atualização da unidade.
address	Object	Informações do endereço da unidade.
contacts	Object	Informações dos contatos da unidade.
vehicles	Array	Informações do veículos registrados na unidade.

Endpoints

Método	Rota	Descrição
POST	/company	Criação de uma unidade.
GET	/company	Lista todos as unidades.
GET	/company/:company_id	Lista uma unidade por ID
PATCH	/company/:company_id	Edita Informações de uma unidade por ID
DELETE	/company/:company_id	Desativa uma unidade por ID

---

4.1. Criação de Unidade

Voltar para os Endpoints

/company

Exemplo de Request:

POST /company
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin
Content-type: application/json

Corpo da Requisição:

{
  "name": "Unidade carioca",
  "openingTime": "09:00 às 18:00",
  "cnpj": "42.607.321/0001-15",
  "address": {
    "district": "Rua Candelária",
    "zipCode": "21754188",
    "number": "500",
    "city": "Rio de Janeiro",
    "state": "RJ"
  },
  "contacts": {
    "phoneNumber": "21983751995"
    "email": "[email protected]"
  }
}

Schema de Validação com Yup:

  name: yup.string().required(),
  openingTime: yup.string().required(),
  cnpj: yup.string().required(),
  address: yup
    .object({
      district: yup.string().required(),
      zipCode: yup.string().max(8).required(),
      number: yup.string().notRequired(),
      city: yup.string().required(),
      state: yup.string().max(2).required(),
    })
    .required(),
  contacts: yup
    .object({
      phoneNumber: yup.string().required(),
      email: yup.string().required(),
    })
    .required(),

OBS.: Chaves não presentes no schema serão removidas.

Exemplo de Response:

201 Created

{
    "id": "3a2bb25f-d20e-495a-925a-245541e9b460",
    "name": "Unidade carioca",
    "openingTime": "09:00 às 18:00",
    "cnpj": "42.607.321/0001-15",
    "address": {
    	"id": "775b52a7-c728-4691-ab87-c06352dbc5b9",
    	"district": "Rua Candelária",
    	"zipCode": "21754188",
    	"number": "500",
    	"city": "Rio de Janeiro",
    	"state": "RJ"
    },
    "contacts": {
    	"id": "f56f163e-93f6-4f75-bf82-f02631029d60",
    	"phoneNumber": "21983751995",
    	"email": "[email protected]"
    },
    "isActive": true,
    "createdAt": "2023-01-18T17:52:34.166Z",
    "updatedAt": "2023-01-18T17:52:34.166Z"
}

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Is not admin.
400 Bad Request	Missing fields.
400 Bad Request	Cnpj/Address/Contact is already registered.

---

4.2. Listando Unidade

Voltar para os Endpoints

/company

Exemplo de Request:

GET /company
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin
Content-type: application/json

Corpo da Requisição:

Vazio

Exemplo de Response:

200 OK

[
  {
    "id": "3a2bb25f-d20e-495a-925a-245541e9b460",
    "name": "Unidade carioca",
    "isActive": true,
    "openingTime": "09:00 às 18:00",
    "cnpj": "42.607.321/0001-15",
    "createdAt": "2023-01-18T17:52:34.166Z",
    "updatedAt": "2023-01-18T17:52:34.166Z",
    "address": {
    	"id": "775b52a7-c728-4691-ab87-c06352dbc5b9",
    	"district": "Rua Candelária",
    	"zipCode": "21754188",
    	"number": "500",
    	"city": "Rio de Janeiro",
    	"state": "RJ"
    },
    "contacts": {
    	"id": "f56f163e-93f6-4f75-bf82-f02631029d60",
    	"phoneNumber": "21983751995",
    	"email": "[email protected]"
    },
  }
]

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Is not admin.

---

4.3. Listando Unidade por ID

Voltar para os Endpoints

/company/:company_id

Exemplo de Request:

GET /users/3a2bb25f-d20e-495a-925a-245541e9b460
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
company_id	string	Identificador único da unidade (Company)

Corpo da Requisição:

Vazio

Exemplo de Response:

200 OK

{
    "id": "3a2bb25f-d20e-495a-925a-245541e9b460",
    "name": "Unidade carioca",
    "isActive": true,
    "openingTime": "09:00 às 18:00",
    "cnpj": "42.607.321/0001-15",
    "createdAt": "2023-01-18T17:52:34.166Z",
    "updatedAt": "2023-01-18T17:52:34.166Z",
    "address": {
    	"id": "775b52a7-c728-4691-ab87-c06352dbc5b9",
    	"district": "Rua Candelária",
    	"zipCode": "21754188",
    	"number": "500",
    	"city": "Rio de Janeiro",
    	"state": "RJ"
    },
    "contacts": {
    	"id": "f56f163e-93f6-4f75-bf82-f02631029d60",
    	"phoneNumber": "21983751995",
    	"email": "[email protected]"
    },
}

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Is not admin.
404 Not found	Company not found.

---

4.4. Editando unidade por ID

Voltar para os Endpoints

/company/:company_id

Exemplo de Request:

PATCH /company/3a2bb25f-d20e-495a-925a-245541e9b460
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
company_id	string	Identificador único da unidade (Company)

Corpo da Requisição:

{
    "openingTime": "11:00 às 15:00"
}

Exemplo de Response:

200 OK

{
    "id": "41eb5a29-80b8-430b-b8aa-e4825a0664d4",
    "openingTime": "11:00 às 15:00",
    "updatedAt": "2023-01-18T17:52:34.166Z"
}

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Is not admin.
404 Not found	Company not found.
400 Bad Request	Missing fields.

---

4.5. Deletando unidade por ID

Voltar para os Endpoints

/company/:company_id

Exemplo de Request:

DELETE /company/3a2bb25f-d20e-495a-925a-245541e9b460
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
company_id	string	Identificador único da unidade (Company)

Corpo da Requisição:

Vazio

Exemplo de Response:

204 No Content

Vazio

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Is not admin.
404 Not found	Company not found.

---

5. Vehicles

Voltar para os Endpoints

O objeto Vehicles é definido como:

Campo	Tipo	Descrição
id	string	Identificador único do veículo.
name	string	O nome do veículo.
sign	string	Placa do veículo.
type	string	Tipo do veículo
companyWorkPlace	Object	Informações da unidade em que o veículo pertence.

Endpoints

Método	Rota	Descrição
POST	/vehicles/company/:company_id	Registro de uma veículo pertencente a uma unidade.
GET	/vehicles/company/:company_id	Lista todos os veículos pertencentes a uma unidade.
DELETE	/vehicles/:vehicle_id	Deleta o registro do veículo

---

5.1. Registro de veículo

Voltar para os Endpoints

/vehicles/company/:company_id

Exemplo de Request:

POST /vehicles/company/3a2bb25f-d20e-495a-925a-245541e9b460
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
company_id	string	Identificador único da unidade (Company)

Corpo da Requisição:

{
    "name": "Fiat Strada 1.6",
    "sign": "JDK-1832",
    "type": "Utilitário"
}

Schema de Validação com Yup:

  name: yup.string().required(),
  sign: yup.string().required(),
  type: yup.string().required(),

OBS.: Chaves não presentes no schema serão removidas.

Exemplo de Response:

201 Created

{
    "id": "d514ee4d-deef-4f26-bdf3-6e972c493c97",
    "name": "Fiat Strada 1.6",
    "sign": "JDK-1832",
    "type": "Utilitário",
    "companyWorkPlace": {
    	"id": "3a2bb25f-d20e-495a-925a-245541e9b460",
    	"name": "Unidade carioca",
    	"isActive": true,
    	"openingTime": "11:00 às 15:00",
    	"cnpj": "42.607.321/0001-15",
    	"createdAt": "2023-01-18T13:16:02.136Z",
    	"updatedAt": "2023-01-18T15:56:36.574Z"
    }
}

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Is not admin.
400 Bad Request	Missing fields.
409 Conflict	Company is deactivate.
404 Not found	Company not found.

---

5.2. Listando veículos

Voltar para os Endpoints

/vehicles/company/:company_id

Exemplo de Request:

GET /vehicles/company/3a2bb25f-d20e-495a-925a-245541e9b460
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
company_id	string	Identificador único da unidade (Company)

Corpo da Requisição:

Vazio

Exemplo de Response:

200 OK

{
    "id": "3a2bb25f-d20e-495a-925a-245541e9b460",
    "name": "Unidade carioca",
    "isActive": true,
    "openingTime": "11:00 às 15:00",
    "cnpj": "42.607.321/0001-15",
    "createdAt": "2023-01-18T13:16:02.136Z",
    "updatedAt": "2023-01-18T15:56:36.574Z",
    "vehicles": [
    	{
    		"id": "d514ee4d-deef-4f26-bdf3-6e972c493c97",
    		"name": "Fiat Strada 1.6",
    		"sign": "JDK-1832",
    		"type": "Utilitário"
    	}
    ]
}

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Is not admin.
409 Conflict	Company is deactivate.
404 Not found	Company not found.

---

5.3. Deletando veículo por ID

Voltar para os Endpoints

/vehicles/:vehicle_id

Exemplo de Request:

DELETE /vehicles/d514ee4d-deef-4f26-bdf3-6e972c493c97
Host: https://kenzielogapi.onrender.com
Authorization: Bearer Token Admin
Content-type: application/json

Parâmetros da Requisição:

Parâmetro	Tipo	Descrição
vehicle_id	string	Identificador único do veículo (Vehicles)

Corpo da Requisição:

Vazio

Exemplo de Response:

204 No Content

Vazio

Possíveis Erros:

Código do Erro	Descrição
401 Unauthorized	Is not admin.
409 Conflict	Company is deactivate.
404 Not found	Company not found.

---