{"info":{"_postman_id":"bedd1d18-6748-4a91-9b3a-555f9a2be277","name":"Order-Application","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"","owner":"50687802","collectionId":"bedd1d18-6748-4a91-9b3a-555f9a2be277","publishedId":"2sBXcLhdiG","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-03-09T23:18:59.000Z"},"item":[{"name":"Auth","item":[{"name":"Login","id":"8bb5c19b-c30f-40b1-be98-e2ef325fae4e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"admin@email.com\",\r\n \"password\": \"123456\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/login","description":"\n

Autentica um usuário validando suas credenciais e retorna um token JWT em caso de sucesso. Este token deve ser utilizado nas requisições subsequentes que exigem autorização.

Corpo da Requisição

O corpo da requisição deve ser enviado como JSON (application/json).

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Obrigatório	Descrição
`email`	string	✅ Sim	O endereço de e-mail cadastrado do usuário
`password`	string	✅ Sim	A senha do usuário

Exemplo:

{\n  \"email\": \"admin@email.com\",\n  \"password\": \"123456\"\n}\n\n

Resposta

Em caso de sucesso, o endpoint retorna HTTP 200 com os seguintes campos:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`user`	string	O e-mail do usuário autenticado.
`token`	string	Um token JWT assinado para ser usado na autenticação.

Exemplo:

{\n  \"user\": \"admin@email.com\",\n  \"token\": \"<token JWT>\"\n}\n\n

Uso

Inclua o token retornado no cabeçalho Authorization das requisições protegidas:

Authorization: Bearer <token>\n\n

","urlObject":{"protocol":"http","port":"3000","path":["login"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"8bb5c19b-c30f-40b1-be98-e2ef325fae4e"}],"id":"f1c4ebc1-0363-42b9-b62e-1629c951c205","_postman_id":"f1c4ebc1-0363-42b9-b62e-1629c951c205","description":""},{"name":"Orders","item":[{"name":"New Order","id":"c205cb06-0ae3-43b0-8391-cbff86c373a0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"numeroPedido\": \"v5\",\r\n \"valorTotal\": 40000,\r\n \"dataCriacao\": \"2023-07-19T12:24:11.5299601+00:00\",\r\n \"items\": [\r\n {\r\n \"idItem\": \"123\",\r\n \"quantidadeItem\": 2,\r\n \"valorItem\": 10000\r\n },\r\n {\r\n \"idItem\": \"321\",\r\n \"quantidadeItem\": 1,\r\n \"valorItem\": 10000\r\n },\r\n {\r\n \"idItem\": \"456\",\r\n \"quantidadeItem\": 2,\r\n \"valorItem\": 10000\r\n },\r\n {\r\n \"idItem\": \"654\",\r\n \"quantidadeItem\": 1,\r\n \"valorItem\": 10000\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/order ","description":"

Novo Pedido

Cria um novo pedido no sistema, enviando os detalhes do pedido incluindo os itens, valor total e data de criação.

Método: POST
URL: http://localhost:3000/order

Corpo da Requisição

O corpo da requisição deve ser enviado como JSON com os seguintes campos:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`numeroPedido`	`string`	Identificador único do pedido
`valorTotal`	`integer`	Valor total do pedido
`dataCriacao`	`string`	Data e hora de criação
`items`	`array`	Lista de itens incluídos no pedido

Objeto do Array de Itens

Cada objeto dentro do array items contém:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`idItem`	`string`	Identificador único do item
`quantidadeItem`	`integer`	Quantidade do item no pedido
`valorItem`	`integer`	Valor unitário do item

Exemplo de Corpo da Requisição

{\n  \"numeroPedido\": \"v10089015vdb-01\",\n  \"valorTotal\": 10000,\n  \"dataCriacao\": \"2023-07-19T12:24:11.5299601+00:00\",\n  \"items\": [\n    { \"idItem\": \"2434\", \"quantidadeItem\": 1, \"valorItem\": 1000 }\n  ]\n}\n\n

Resposta

`201 Created` — Pedido criado com sucesso

{\n  \"message\": \"O pedido foi criado com sucesso!\"\n}\n\n

Retornado quando o pedido é criado com sucesso. A resposta confirma a operação com uma mensagem de sucesso.

\n","urlObject":{"protocol":"http","port":"3000","path":["order "],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"c205cb06-0ae3-43b0-8391-cbff86c373a0"},{"name":"List Orders","id":"f99ad1cf-0ad6-4edb-8526-195ed4039870","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:3000/order/list","description":"

Listar Pedidos

Retorna uma lista com todos os pedidos cadastrados no sistema. A resposta é um array de objetos, onde cada objeto contém o identificador do pedido, o valor total e a data de criação.

Método: GET
URL: http://localhost:3000/order/list

Campos da Resposta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`orderId`	`string`	Identificador único do pedido.
`value`	`string`	Valor monetário total do pedido.
`creationDate`	`string`	Timestamp indicando quando o pedido foi criado.

Exemplo de Resposta

[\n  {\n    \"orderId\": \"v10089015vdb-01\",\n    \"value\": \"10000.00\",\n    \"creationDate\": \"2023-07-19T12:24:11.000Z\"\n  },\n  {\n    \"orderId\": \"v2\",\n    \"value\": \"4000.00\",\n    \"creationDate\": \"2023-07-19T12:24:11.000Z\"\n  },\n  {\n    \"orderId\": \"v3\",\n    \"value\": \"40000.00\",\n    \"creationDate\": \"2023-07-19T12:24:11.000Z\"\n  },\n  {\n    \"orderId\": \"v4\",\n    \"value\": \"40000.00\",\n    \"creationDate\": \"2023-07-19T12:24:11.000Z\"\n  }\n]\n\n

Código de Status: 200 OK

\n","urlObject":{"protocol":"http","port":"3000","path":["order","list"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"f99ad1cf-0ad6-4edb-8526-195ed4039870"},{"name":"Find Order By ID","id":"d802aacf-1075-4d9b-a14a-a62e4063f718","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:3000/order/v10089015vdb-01","description":"

Buscar Pedido por ID

Retorna os detalhes de um pedido específico com base no seu identificador único (orderId).

Método e URL

GET http://localhost:3000/order/:orderId\n\n

Parâmetros de Caminho (Path Variables)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parâmetro	Tipo	Obrigatório	Descrição
`orderId`	string	Sim	Identificador único do pedido. Ex: `v10089015vdb-01`

Exemplo de Requisição

GET http://localhost:3000/order/v10089015vdb-01\n\n

Resposta de Sucesso

Código: 200 OK

{\n  \"order\": {\n    \"orderId\": \"v10089015vdb-01\",\n    \"value\": \"10000.00\",\n    \"creationDate\": \"2023-07-19T12:24:11.000Z\"\n  },\n  \"items\": [\n    {\n      \"id\": 2,\n      \"orderId\": \"v10089015vdb-01\",\n      \"productId\": 2434,\n      \"quantity\": 1,\n      \"price\": \"1000.00\"\n    }\n  ]\n}\n\n

Campos da Resposta

Objeto order

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`orderId`	string	Identificador único do pedido.
`value`	string	Valor total do pedido.
`creationDate`	string	Data e hora de criação do pedido.

Array items

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`id`	integer	Identificador único do item.
`orderId`	string	Identificador do pedido ao qual o item pertence.
`productId`	integer	Identificador do produto.
`quantity`	integer	Quantidade do produto no pedido.
`price`	string	Preço unitário do produto.

Possíveis Erros

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Descrição
`404`	Pedido não encontrado para o ID informado.
`500`	Erro interno do servidor

","urlObject":{"protocol":"http","port":"3000","path":["order","v10089015vdb-01"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"d802aacf-1075-4d9b-a14a-a62e4063f718"},{"name":"Update Order","id":"50dd2793-bf84-45b1-b238-da159b17afa1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"order\": {\r\n \"orderId\": \"v10089015vdb-01\",\r\n \"value\": \"15000.00\",\r\n \"creationDate\": \"2023-07-19T12:24:11.000Z\"\r\n },\r\n \"items\": [\r\n {\r\n \"id\": 2,\r\n \"orderId\": \"v10089015vdb-01\",\r\n \"productId\": 2434,\r\n \"quantity\": 1,\r\n \"price\": \"1000.00\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/order/v2","description":"

Atualizar Pedido

Atualiza um pedido existente no sistema.

Endpoint

PUT http://localhost:3000/order/v10089015vdb-01

Corpo da Requisição

O corpo da requisição deve ser enviado como JSON e contém os campos:

`order` (objeto)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`orderId`	`string`	Identificador único do pedido a ser atualizado.
`value`	`string`	Valor total do pedido.
`creationDate`	`string`	Data de criação do pedido.

`items` (array de objetos)

Cada elemento do array items representa um produto associado ao pedido.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descrição
`id`	`integer`	Identificador único do item do pedido.
`orderId`	`string`	Identificador do pedido ao qual este item pertence. Deve corresponder ao `order.orderId`.
`productId`	`integer`	Identificador do produto sendo pedido.
`quantity`	`integer`	Quantidade do produto.
`price`	`string`	Preço unitário do produto.

Exemplo de corpo da requisição:

{\n  \"order\": {\n    \"orderId\": \"v10089015vdb-01\",\n    \"value\": \"15000.00\",\n    \"creationDate\": \"2023-07-19T12:24:11.000Z\"\n  },\n  \"items\": [\n    {\n      \"id\": 2,\n      \"orderId\": \"v10089015vdb-01\",\n      \"productId\": 2434,\n      \"quantity\": 1,\n      \"price\": \"1000.00\"\n    }\n  ]\n}\n\n

Resposta

`200 OK` — Pedido atualizado com sucesso

{\n  \"message\": \"Pedido atualizado com sucesso!\"\n}\n\n

A mensagem \"Pedido atualizado com sucesso!\" confirma que o pedido foi atualizado com êxito.

\n","urlObject":{"protocol":"http","port":"3000","path":["order","v2"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"50dd2793-bf84-45b1-b238-da159b17afa1"},{"name":"Delete Order","id":"505a9a47-8eda-4bf7-b966-189b425238c1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"DELETE","header":[],"body":{"mode":"raw","raw":""},"url":"http://localhost:3000/order/v5","description":"

Deletar Pedido

Remove um pedido existente do sistema.

Método: DELETE
URL: http://localhost:3000/order/v10089015vdb-01

Resposta

\n\n\n\n\n\n\n\n\n\n\n\n\n

Código de Status	Descrição
`200 OK`	O pedido foi deletado com sucesso.

Corpo da Resposta (Sucesso):

{\n  \"message\": \"Pedido deletado com sucesso!\"\n}\n\n

\n
Observação: A resposta retorna uma mensagem de confirmação indicando que o pedido foi removido com sucesso.
\n

\n","urlObject":{"protocol":"http","port":"3000","path":["order","v5"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"505a9a47-8eda-4bf7-b966-189b425238c1"}],"id":"1f25a6ad-9dd1-4f16-b5b7-63bfe7807a67","_postman_id":"1f25a6ad-9dd1-4f16-b5b7-63bfe7807a67","description":""}]}

Login

Corpo da Requisição

Resposta

Uso

Novo Pedido

Corpo da Requisição

Objeto do Array de Itens

Exemplo de Corpo da Requisição

Resposta

201 Created — Pedido criado com sucesso

Listar Pedidos

Campos da Resposta

Exemplo de Resposta

Buscar Pedido por ID

Método e URL

Parâmetros de Caminho (Path Variables)

Exemplo de Requisição

Resposta de Sucesso

Campos da Resposta

Possíveis Erros

Atualizar Pedido

Endpoint

Corpo da Requisição

order (objeto)

items (array de objetos)

Resposta

200 OK — Pedido atualizado com sucesso

Deletar Pedido

Resposta

`201 Created` — Pedido criado com sucesso

`order` (objeto)

`items` (array de objetos)

`200 OK` — Pedido atualizado com sucesso