Esta API permite gerenciar um catálogo de produtos smartphones, oferecendo funcionalidades para criar, listar, atualizar e excluir produtos. Ela foi projetada para permitir a integração com sistemas de e-commerce, inventário ou qualquer aplicação que precise manipular dados relacionados a produtos.
\nA API trabalha com as seguintes operações principais:
\nCriar Produtos: Adicione novos celulares ao catálogo especificando detalhes como título, descrição, quantidade e preço.
\nListar Produtos: Consulte a lista completa dos celulares ou obtenha informações detalhadas de um produto específico.
\nAtualizar Produtos: Modifique as informações de produtos existentes.
\nExcluir Produtos: Remova produtos do catálogo.
\nCada produto armazenado na API possui a seguinte estrutura de dados:
\n{\n \"id\": \"unique-id\",\n \"title\": \"Product Title\",\n \"description\": \"Product Description\",\n \"quantity\": 10,\n \"price\": 99.99\n}\n\nDescrição: Esta requisição cria um novo \"produto\" com os dados fornecidos no corpo da requisição.
\nMétodo: POST
\nURL: http://localhost:3000/api/products
Resposta:
\n201 OK: Sucesso.
\n404 Not Found: Produto não encontrado.
\nCorpo da requisição:
\nDescrição: Retorna todos os produtos.
\nMétodo: GET
\nURL: http://localhost:3000/api/products
Resposta:
\n200 OK: Sucesso.
\n404 Not Found: Produto não encontrado.
\nDescrição: Retorna um produto específico pelo ID.
\nMétodo: GET
\nURL: http://localhost:3000/api/products/{id}
Resposta:
\n200 OK: Sucesso.
\n404 Not Found: Produto não encontrado.
\nDescrição: Atualiza um produto existente.
\nMétodo: PUT.
\nURL: http://localhost:3000/api/products/{id}
Resposta:
\n200 OK: Produto atualizado com sucesso.
\n404 Not Found: Produto não encontrado.
\nCorpo da requisição:
\nDescrição: Exclui um produto do arquivo JSON..
\nMétodo: DELETE.
\nURL: http://localhost:3000/api/products/{id}
Resposta:
\n204 No Content: Sucesso.
\n404 Not Found: Produto não encontrado.
\nNesta versão, a API utiliza um arquivo local JSON como banco de dados. Ela oferece endpoints para criar, listar, atualizar e excluir produtos.
\nNode.js instalado localmente.
\nArquivo products.json armazenado localmente para persistir os dados.
Dependências (como Express, Mongoose, e File System) devem estar instaladas via npm install.
Vai criar e gerenciar o campo id manualmente
1.3. Endpoints👇
\n","_postman_id":"f326ccc8-8a73-48df-a968-cbab21981557"},{"name":"2. Documentação da API para Produção (MongoDB no Vercel)","item":[{"name":"Create Product","event":[{"listen":"test","script":{"id":"da2e5b08-c765-4fae-819a-68fec6842530","exec":["pm.test(\"Successful POST request\", function () {"," pm.expect(pm.response.code).to.be.oneOf([200, 201]);","});",""],"type":"text/javascript","packages":{}}}],"id":"66eeb0e5-5af5-4108-98b9-6039896e6c8f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"title\": \"Samsung Galaxy S23\",\n \"description\": \"Samsung Galaxy S23 com 256GB e câmera de 108MP para fotos incríveis.\",\n \"quantity\": 15,\n \"price\": 5.999\n} ","options":{"raw":{"language":"json"}}},"url":"https://raizertech.vercel.app/api/products","description":"Descrição: Esta requisição cria um novo \"produto\" com os dados fornecidos no corpo da requisição.
\nMétodo: POST
\nResposta:
\n201 OK: Sucesso.
\n404 Not Found: Produto não encontrado.
\nCorpo da requisição:
\nDescrição: Retorna todos os produtos.
\nMétodo: GET
\nResposta:
\n200 OK: Sucesso.
\n404 Not Found: Produto não encontrado.
\nDescrição: Retorna um produto específico pelo ID.
\nMétodo: GET
\nResposta:
\n200 OK: Sucesso.
\n404 Not Found: Produto não encontrado.
\nDescrição: Atualiza um produto existente.
\nMétodo: PUT.
\nResposta:
\n200 OK: Produto atualizado com sucesso.
\n404 Not Found: Produto não encontrado.
\nCorpo da requisição:
\nDescrição: Deleta um produto existente.
\nMétodo: DELETE
\nResposta:
\n204 No Content: Sucesso.
\n404 Not Found: Produto não encontrado.
\nNa produção, a API utiliza o MongoDB como banco de dados, gerenciado por meio da plataforma Vercel. A API oferece os mesmos endpoints, mas agora os dados são persistidos no MongoDB.
\nConfigurar o banco de dados MongoDB Atlas.
\nVariáveis de ambiente configuradas no Vercel (MONGODB_URI).
Vai gerar automaticamente o campo _id em vez de id.
Os endpoints e a estrutura de resposta/solicitação são os mesmos da versão local, com a diferença de que agora os dados são armazenados no MongoDB.
\n","_postman_id":"4f7a9027-fea8-46e3-b96b-f6d678567f2b"}],"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""]}},{"listen":"test","script":{"type":"text/javascript","exec":[""]}}],"variable":[{"id":"05806922-35de-41e8-a7b7-bc2920d1c2d4","key":"id","value":"1"},{"id":"58959698-c60f-4bd1-988f-27291af7e97a","key":"base_url","value":"https://postman-rest-api-learner.glitch.me/"}]}