Adicionar Item ao Carrinho
Em desenvolvimento
POST
/orders/create/
Rota: /orders/create/
Descrição: Esta rota é designada para permitir que um usuário adicione um produto a uma lista de compra temporária, funcionando como um carrinho de compras. A requisição exige o identificador único do produto (productId) e a quantidade desejada. O sistema é responsável por validar a existência do produto, verificar a disponibilidade em estoque e o status atual do produto antes de adicioná-lo ao carrinho do usuário.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/orders/create/' \
--header 'Content-Type: application/json' \
--data-raw '{
"userId": "323232", // Identificação do perfil que solicitou (ou inferido pelo token de autenticação)
"productId": "PROD-123456", // ID único do produto a ser adicionado
"quantity": 1 // Quantidade de unidades do produto
}'Response Response Example
200 - Example 1
{
"message": {
"title": "Item Adicionado ao Carrinho",
"text": "O produto foi adicionado com sucesso à sua lista temporária.",
"description": "Seu carrinho de compras foi atualizado. Você pode continuar adicionando itens ou prosseguir para o checkout."
},
"success": true,
"status": 200,
"data": {
"cartId": "CART-123456", // ID do carrinho do usuário
"userId": "323232",
"totalItemsInCart": 3, // Quantidade total de itens únicos no carrinho
"totalCartValue": 250.75, // Valor total do carrinho
"addedItem": { // Detalhes do item que acabou de ser adicionado/atualizado
"productId": "PROD-123456",
"name": "Jantar Romântico Sítio do Bosco",
"quantity": 2, // Quantidade atual desse item no carrinho
"unitPrice": 90.00,
"totalItemPrice": 180.00
},
"cartItems": [ // Lista simplificada dos itens no carrinho
{
"productId": "PROD-123456",
"name": "Jantar Romântico Sítio do Bosco",
"quantity": 2,
"unitPrice": 90.00
},
{
"productId": "PROD-45789",
"name": "Passeio de Barco",
"quantity": 1,
"unitPrice": 70.75
}
]
}
}Requisição
Parâmetros Bodyapplication/json
Respostas
Modificado em 2025-06-12 00:12:21