{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"8e159ba2-6e37-4d9f-90a5-3cfc22cde9bf","name":"E-commerce API","description":"# E-commerce API Documentation\n\n## Overview\n\nWelcome to the E-commerce API documentation. This RESTful API provides a comprehensive solution for managing an online store, including product catalog management, shopping cart functionality, and order processing.\n\n## Base URL\n\n```\nhttp://localhost:5000\n\n ```\n\nAll API endpoints are relative to this base URL.\n\n## Authentication\n\nThis API uses **Bearer Token** authentication. Include your API key in the Authorization header for all requests:\n\n```\nAuthorization: Bearer {{api_key}}\n\n ```\n\nTo obtain an API key, please contact your system administrator or register through the developer portal.\n\n## API Structure\n\nThe API is organized into three main resource groups:\n\n### 📦 Products\n\nManage your product catalog with full CRUD operations. Create, read, update, and delete products with detailed information including pricing, inventory, and descriptions.\n\n### 🛒 Cart\n\nHandle shopping cart operations for your customers. Add items, update quantities, retrieve cart contents, and remove items seamlessly.\n\n### 📋 Orders\n\nProcess and manage customer orders. Create new orders from cart contents, retrieve order history, and view detailed order information.\n\n## Response Format\n\nAll responses are returned in JSON format with appropriate HTTP status codes:\n\n- `200 OK` - Successful GET, PUT requests\n    \n- `201 Created` - Successful POST requests\n    \n- `204 No Content` - Successful DELETE requests\n    \n- `400 Bad Request` - Invalid request parameters\n    \n- `401 Unauthorized` - Missing or invalid authentication\n    \n- `404 Not Found` - Resource not found\n    \n- `500 Internal Server Error` - Server error\n    \n\n## Rate Limiting\n\nAPI requests are limited to 1000 requests per hour per API key. Rate limit information is included in response headers:\n\n- `X-RateLimit-Limit` - Maximum requests per hour\n    \n- `X-RateLimit-Remaining` - Remaining requests in current window\n    \n- `X-RateLimit-Reset` - Time when the rate limit resets (Unix timestamp)\n    \n\n## Error Handling\n\nError responses include a descriptive message:\n\n``` json\n{\n  \"error\": \"Error description\",\n  \"message\": \"Detailed error message\",\n  \"statusCode\": 400\n}\n\n ```\n\n## Getting Started\n\n1. Obtain your API key\n    \n2. Set up the `api_key` variable in your Postman environment\n    \n3. Start with the Products endpoints to populate your catalog\n    \n4. Use Cart endpoints to simulate customer shopping experience\n    \n5. Create orders using the Orders endpoints\n    \n\n## Support\n\nFor API support, bug reports, or feature requests, please contact:\n\n- Email: [api-support@ecommerce.com](https://mailto:api-support@ecommerce.com)\n    \n- Documentation: [https://docs.ecommerce.com/api](https://docs.ecommerce.com/api)\n    \n- Status Page: [https://status.ecommerce.com](https://status.ecommerce.com)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"50522412","team":11938088,"collectionId":"8e159ba2-6e37-4d9f-90a5-3cfc22cde9bf","publishedId":"2sBXcBm21t","public":true,"publicUrl":"https://documenter-api.postman.tech/view/50522412/2sBXcBm21t","privateUrl":"https://go.postman.co/documentation/50522412-8e159ba2-6e37-4d9f-90a5-3cfc22cde9bf","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Welcome to the E-commerce API documentation. This RESTful API provides a comprehensive solution for managing an online store, including product catalog management, shopping cart functionality, and order processing."},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.0","publishDate":"2026-02-12T09:04:04.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":"Welcome to the E-commerce API documentation. This RESTful API provides a comprehensive solution for managing an online store, including product catalog management, shopping cart functionality, and order processing."},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/73e3a182bb7f0a4b78a0fb3b24447bd5faecc6b81f55986f216592e31024f6e2","favicon":""},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/2sBXcBm21t"}