{ "info": { "name": "WaterRush - Customer API", "description": "Customer-facing API collection for the Water Rush water delivery application. All routes are prefixed with /api/customer/. Public routes require no auth. Protected routes require a valid Bearer token obtained from login/register.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "waterrush" }, "variable": [ { "key": "base_url", "value": "http://127.0.0.1:8000" }, { "key": "token", "value": "" } ], "item": [ { "name": "Auth", "item": [ { "name": "Register", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Ahmed Hassan\",\n \"phone\": \"01001234567\",\n \"password\": \"password123\",\n \"password_confirmation\": \"password123\"\n}" }, "url": { "raw": "{{base_url}}/api/customer/auth/register", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "auth", "register" ] }, "description": "Register a new customer account. Returns a Sanctum token and customer data." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Registered successfully\",\n \"data\": {\n \"token\": \"1|abc123def456...\",\n \"customer\": {\n \"id\": 1,\n \"name\": \"Ahmed Hassan\",\n \"phone\": \"01001234567\"\n }\n }\n}" }, { "name": "Validation Error", "status": "Unprocessable Entity", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"The phone has already been taken.\",\n \"errors\": {\n \"phone\": [\"The phone has already been taken.\"]\n }\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "// Extract token from register response and set as collection variable", "const json = pm.response.json();", "if (json.status === true && json.data && json.data.token) {", " pm.collectionVariables.set('token', json.data.token);", "}" ] } } ] }, { "name": "Login", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"phone\": \"01001234567\",\n \"password\": \"password123\"\n}" }, "url": { "raw": "{{base_url}}/api/customer/auth/login", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "auth", "login" ] }, "description": "Login with phone and password. Returns a Sanctum token. Copy the token value into the `token` collection variable for protected routes." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Login successful\",\n \"data\": {\n \"token\": \"2|xyz789abc012...\",\n \"customer\": {\n \"id\": 1,\n \"name\": \"Ahmed Hassan\",\n \"phone\": \"01001234567\"\n }\n }\n}" }, { "name": "Invalid Credentials", "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": false,\n \"message\": \"Invalid credentials\"\n}" } ], "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "// Extract token from login response and set as collection variable", "const json = pm.response.json();", "if (json.status === true && json.data && json.data.token) {", " pm.collectionVariables.set('token', json.data.token);", "}" ] } } ] }, { "name": "Logout", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/api/customer/auth/logout", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "auth", "logout" ] }, "description": "Revoke the current access token." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Logged out successfully\"\n}" } ] }, { "name": "Get Profile (Me)", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/api/customer/auth/me", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "auth", "me" ] }, "description": "Get the authenticated customer\u0027s profile data." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"data\": {\n \"customer\": {\n \"id\": 1,\n \"name\": \"Ahmed Hassan\",\n \"phone\": \"01001234567\",\n \"is_active\": true\n }\n }\n}" } ] }, { "name": "Update Profile", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"Ahmed Hassan Mohamed\"\n}" }, "url": { "raw": "{{base_url}}/api/customer/auth/profile", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "auth", "profile" ] }, "description": "Update the authenticated customer\u0027s name." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Profile updated successfully\",\n \"data\": {\n \"customer\": {\n \"id\": 1,\n \"name\": \"Ahmed Hassan Mohamed\",\n \"phone\": \"01001234567\",\n \"is_active\": true\n }\n }\n}" } ] } ], "description": "Authentication endpoints for customer registration, login, logout, and profile management." }, { "name": "Sliders", "item": [ { "name": "List Sliders", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/customer/sliders", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "sliders" ] }, "description": "Get all active sliders ordered by sort_order ascending. Returns full image URLs." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Sliders fetched successfully\",\n \"data\": {\n \"sliders\": [\n {\n \"id\": 1,\n \"image\": \"http://127.0.0.1:8000/storage/sliders/summer-promo.jpg\",\n \"link\": \"https://waterrush.com/promos/summer\",\n \"sort_order\": 0\n },\n {\n \"id\": 2,\n \"image\": \"http://127.0.0.1:8000/storage/sliders/new-arrival.jpg\",\n \"link\": null,\n \"sort_order\": 1\n }\n ]\n }\n}" } ] } ], "description": "Public endpoints for fetching homepage slider images." }, { "name": "Categories", "item": [ { "name": "List Categories", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/customer/categories", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "categories" ] }, "description": "Get all active categories with their active products and product images (full URLs)." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Categories fetched successfully\",\n \"data\": {\n \"categories\": [\n {\n \"id\": 1,\n \"name\": \"Mineral Water\",\n \"products\": [\n {\n \"id\": 1,\n \"title\": \"Water Bottle 1.5L\",\n \"description\": \"Pure natural mineral water 1.5 liter bottle\",\n \"price\": 10.00,\n \"price_before\": null,\n \"images\": [\n {\n \"id\": 1,\n \"image\": \"http://127.0.0.1:8000/storage/products/bottle-1.5l.jpg\",\n \"sort_order\": 0\n }\n ]\n }\n ]\n },\n {\n \"id\": 2,\n \"name\": \"Large Containers\",\n \"products\": [\n {\n \"id\": 2,\n \"title\": \"Water Gallon 19L\",\n \"description\": \"Large 19-liter water gallon for home dispensers\",\n \"price\": 35.00,\n \"price_before\": 40.00,\n \"images\": [\n {\n \"id\": 2,\n \"image\": \"http://127.0.0.1:8000/storage/products/gallon-19l.jpg\",\n \"sort_order\": 0\n }\n ]\n }\n ]\n }\n ]\n }\n}" } ] } ], "description": "Public endpoints for fetching product categories." }, { "name": "Products", "item": [ { "name": "List Products", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/customer/products", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "products" ] }, "description": "Get paginated list of active products with images and category name." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Products fetched successfully\",\n \"data\": {\n \"current_page\": 1,\n \"data\": [\n {\n \"id\": 1,\n \"title\": \"Water Bottle 1.5L\",\n \"description\": \"Pure natural mineral water 1.5 liter bottle\",\n \"price\": 10.00,\n \"price_before\": null,\n \"category\": \"Mineral Water\",\n \"images\": [\n {\n \"id\": 1,\n \"image\": \"http://127.0.0.1:8000/storage/products/bottle-1.5l.jpg\",\n \"sort_order\": 0\n }\n ]\n },\n {\n \"id\": 2,\n \"title\": \"Water Gallon 19L\",\n \"description\": \"Large 19-liter water gallon for home dispensers\",\n \"price\": 35.00,\n \"price_before\": 40.00,\n \"category\": \"Large Containers\",\n \"images\": [\n {\n \"id\": 2,\n \"image\": \"http://127.0.0.1:8000/storage/products/gallon-19l.jpg\",\n \"sort_order\": 0\n }\n ]\n }\n ],\n \"first_page_url\": \"http://127.0.0.1:8000/api/customer/products?page=1\",\n \"from\": 1,\n \"last_page\": 1,\n \"last_page_url\": \"http://127.0.0.1:8000/api/customer/products?page=1\",\n \"next_page_url\": null,\n \"path\": \"http://127.0.0.1:8000/api/customer/products\",\n \"per_page\": 15,\n \"prev_page_url\": null,\n \"to\": 2,\n \"total\": 2\n }\n}" } ] }, { "name": "List Products by Category", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/customer/products?category_id=1", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "products" ], "query": [ { "key": "category_id", "value": "1" } ] }, "description": "Get active products filtered by category_id." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Products fetched successfully\",\n \"data\": {\n \"current_page\": 1,\n \"data\": [\n {\n \"id\": 1,\n \"title\": \"Water Bottle 1.5L\",\n \"description\": \"Pure natural mineral water 1.5 liter bottle\",\n \"price\": 10.00,\n \"price_before\": null,\n \"category\": \"Mineral Water\",\n \"images\": [\n {\n \"id\": 1,\n \"image\": \"http://127.0.0.1:8000/storage/products/bottle-1.5l.jpg\",\n \"sort_order\": 0\n }\n ]\n }\n ],\n \"total\": 1,\n \"per_page\": 15\n }\n}" } ] }, { "name": "Get Product", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/customer/products/1", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "products", "1" ] }, "description": "Get a single active product by ID with images and category details." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Product fetched successfully\",\n \"data\": {\n \"product\": {\n \"id\": 1,\n \"title\": \"Water Bottle 1.5L\",\n \"description\": \"Pure natural mineral water 1.5 liter bottle\",\n \"price\": 10.00,\n \"price_before\": null,\n \"category\": {\n \"id\": 1,\n \"name\": \"Mineral Water\"\n },\n \"images\": [\n {\n \"id\": 1,\n \"image\": \"http://127.0.0.1:8000/storage/products/bottle-1.5l.jpg\",\n \"sort_order\": 0\n }\n ]\n }\n }\n}" }, { "name": "Not Found", "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": false,\n \"message\": \"Not found\"\n}" } ] } ], "description": "Public endpoints for browsing active products." }, { "name": "Scheduled Times", "item": [ { "name": "List Scheduled Times", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{base_url}}/api/customer/scheduled-times", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "scheduled-times" ] }, "description": "Get all active delivery time slots." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Scheduled times fetched successfully\",\n \"data\": {\n \"scheduled_times\": [\n {\n \"id\": 1,\n \"label\": \"Morning 9AM-12PM\",\n \"time_from\": \"09:00:00\",\n \"time_to\": \"12:00:00\"\n },\n {\n \"id\": 2,\n \"label\": \"Afternoon 12PM-3PM\",\n \"time_from\": \"12:00:00\",\n \"time_to\": \"15:00:00\"\n },\n {\n \"id\": 3,\n \"label\": \"Evening 3PM-6PM\",\n \"time_from\": \"15:00:00\",\n \"time_to\": \"18:00:00\"\n },\n {\n \"id\": 4,\n \"label\": \"Night 6PM-9PM\",\n \"time_from\": \"18:00:00\",\n \"time_to\": \"21:00:00\"\n }\n ]\n }\n}" } ] } ], "description": "Public endpoints for fetching available delivery time slots." }, { "name": "Addresses", "item": [ { "name": "List Addresses", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/api/customer/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "addresses" ] }, "description": "Get the authenticated customer\u0027s saved addresses." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Addresses fetched successfully\",\n \"data\": {\n \"addresses\": [\n {\n \"id\": 1,\n \"customer_id\": 1,\n \"title\": \"Home\",\n \"address\": \"15 El-Tahrir Street, Downtown, Cairo\",\n \"lat\": 30.044420,\n \"lng\": 31.235712,\n \"is_default\": true,\n \"created_at\": \"2026-05-11T08:00:00.000000Z\",\n \"updated_at\": \"2026-05-11T08:00:00.000000Z\"\n },\n {\n \"id\": 2,\n \"customer_id\": 1,\n \"title\": \"Office\",\n \"address\": \"42 El-Maadi Street, Maadi, Cairo\",\n \"lat\": 29.960420,\n \"lng\": 31.265712,\n \"is_default\": false,\n \"created_at\": \"2026-05-12T10:00:00.000000Z\",\n \"updated_at\": \"2026-05-12T10:00:00.000000Z\"\n }\n ]\n }\n}" } ] }, { "name": "Create Address", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"title\": \"Home\",\n \"address\": \"15 El-Tahrir Street, Downtown, Cairo\",\n \"lat\": 30.044420,\n \"lng\": 31.235712,\n \"is_default\": true\n}" }, "url": { "raw": "{{base_url}}/api/customer/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "addresses" ] }, "description": "Create a new delivery address for the authenticated customer." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Address created successfully\",\n \"data\": {\n \"address\": {\n \"id\": 3,\n \"customer_id\": 1,\n \"title\": \"Home\",\n \"address\": \"15 El-Tahrir Street, Downtown, Cairo\",\n \"lat\": 30.044420,\n \"lng\": 31.235712,\n \"is_default\": true,\n \"created_at\": \"2026-05-13T11:00:00.000000Z\",\n \"updated_at\": \"2026-05-13T11:00:00.000000Z\"\n }\n }\n}" } ] }, { "name": "Update Address", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"title\": \"Home (Updated)\",\n \"address\": \"17 El-Tahrir Street, Downtown, Cairo\",\n \"lat\": 30.045000,\n \"lng\": 31.236000,\n \"is_default\": true\n}" }, "url": { "raw": "{{base_url}}/api/customer/addresses/1", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "addresses", "1" ] }, "description": "Update an existing delivery address." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Address updated successfully\",\n \"data\": {\n \"address\": {\n \"id\": 1,\n \"customer_id\": 1,\n \"title\": \"Home (Updated)\",\n \"address\": \"17 El-Tahrir Street, Downtown, Cairo\",\n \"lat\": 30.045000,\n \"lng\": 31.236000,\n \"is_default\": true,\n \"created_at\": \"2026-05-11T08:00:00.000000Z\",\n \"updated_at\": \"2026-05-13T11:05:00.000000Z\"\n }\n }\n}" } ] }, { "name": "Delete Address", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/api/customer/addresses/2", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "addresses", "2" ] }, "description": "Delete an address. You must have at least one address remaining." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Address deleted successfully\"\n}" }, { "name": "Cannot Delete Last Address", "status": "Unprocessable Entity", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": false,\n \"message\": \"You must have at least one address\"\n}" } ] }, { "name": "Set Default Address", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/api/customer/addresses/1/set-default", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "addresses", "1", "set-default" ] }, "description": "Set a specific address as the default delivery address. All other addresses are set to non-default." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Default address updated successfully\",\n \"data\": {\n \"address\": {\n \"id\": 1,\n \"customer_id\": 1,\n \"title\": \"Home\",\n \"address\": \"15 El-Tahrir Street, Downtown, Cairo\",\n \"lat\": 30.044420,\n \"lng\": 31.235712,\n \"is_default\": true,\n \"created_at\": \"2026-05-11T08:00:00.000000Z\",\n \"updated_at\": \"2026-05-13T11:10:00.000000Z\"\n }\n }\n}" } ] } ], "description": "Protected endpoints for managing delivery addresses." }, { "name": "Cart", "item": [ { "name": "Get Cart", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/api/customer/cart", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "cart" ] }, "description": "Get the authenticated customer\u0027s cart with all items, product/bundle info, and total." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Cart fetched successfully\",\n \"data\": {\n \"cart\": {\n \"id\": 1,\n \"items\": [\n {\n \"id\": 1,\n \"product_id\": 1,\n \"bundle_id\": null,\n \"title\": \"Water Bottle 1.5L\",\n \"price\": 10.00,\n \"image\": \"http://127.0.0.1:8000/storage/products/bottle-1.5l.jpg\",\n \"quantity\": 6,\n \"item_subtotal\": 60.00\n },\n {\n \"id\": 2,\n \"product_id\": null,\n \"bundle_id\": 1,\n \"title\": \"Family Pack (6 x 1.5L)\",\n \"price\": 50.00,\n \"image\": \"http://127.0.0.1:8000/storage/bundles/family-pack.jpg\",\n \"quantity\": 1,\n \"item_subtotal\": 50.00\n }\n ],\n \"total\": 110.00\n }\n }\n}" } ] }, { "name": "Add Item (Product)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"product_id\": 1,\n \"quantity\": 6\n}" }, "url": { "raw": "{{base_url}}/api/customer/cart/items", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "cart", "items" ] }, "description": "Add a product to the cart. If the item already exists, quantity is incremented." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Item added successfully\",\n \"data\": {\n \"item\": {\n \"id\": 1,\n \"cart_id\": 1,\n \"product_id\": 1,\n \"bundle_id\": null,\n \"quantity\": 6,\n \"created_at\": \"2026-05-13T11:15:00.000000Z\",\n \"updated_at\": \"2026-05-13T11:15:00.000000Z\"\n }\n }\n}" } ] }, { "name": "Add Item (Bundle)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"bundle_id\": 1,\n \"quantity\": 1\n}" }, "url": { "raw": "{{base_url}}/api/customer/cart/items", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "cart", "items" ] }, "description": "Add a bundle to the cart. A product_id and bundle_id cannot both be sent in the same request." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Item added successfully\",\n \"data\": {\n \"item\": {\n \"id\": 2,\n \"cart_id\": 1,\n \"product_id\": null,\n \"bundle_id\": 1,\n \"quantity\": 1,\n \"created_at\": \"2026-05-13T11:16:00.000000Z\",\n \"updated_at\": \"2026-05-13T11:16:00.000000Z\"\n }\n }\n}" } ] }, { "name": "Update Cart Item", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"quantity\": 3\n}" }, "url": { "raw": "{{base_url}}/api/customer/cart/items/1", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "cart", "items", "1" ] }, "description": "Update the quantity of a cart item (min 1)." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Item updated successfully\",\n \"data\": {\n \"item\": {\n \"id\": 1,\n \"cart_id\": 1,\n \"product_id\": 1,\n \"bundle_id\": null,\n \"quantity\": 3,\n \"created_at\": \"2026-05-13T11:15:00.000000Z\",\n \"updated_at\": \"2026-05-13T11:17:00.000000Z\"\n }\n }\n}" } ] }, { "name": "Remove Cart Item", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/api/customer/cart/items/2", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "cart", "items", "2" ] }, "description": "Remove a specific item from the cart." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Item removed successfully\"\n}" } ] }, { "name": "Clear Cart", "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/api/customer/cart", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "cart" ] }, "description": "Remove all items from the cart." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Cart cleared successfully\"\n}" } ] } ], "description": "Protected endpoints for managing the shopping cart." }, { "name": "Promo Codes", "item": [ { "name": "Apply Promo Code", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"code\": \"SAVE10\"\n}" }, "url": { "raw": "{{base_url}}/api/customer/promo-codes/apply", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "promo-codes", "apply" ] }, "description": "Validate and apply a promo code. Checks if the code is active, not expired, and not exhausted." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Promo code applied\",\n \"data\": {\n \"code\": \"SAVE10\",\n \"type\": \"percent\",\n \"discount\": 10\n }\n}" }, { "name": "Invalid Code", "status": "Unprocessable Entity", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": false,\n \"message\": \"Invalid promo code\"\n}" }, { "name": "Expired Code", "status": "Unprocessable Entity", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": false,\n \"message\": \"Promo code expired\"\n}" }, { "name": "Exhausted Code", "status": "Unprocessable Entity", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": false,\n \"message\": \"Promo code exhausted\"\n}" } ] } ], "description": "Protected endpoint for applying promo codes." }, { "name": "Orders", "item": [ { "name": "List Orders", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/api/customer/orders", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "orders" ] }, "description": "Get the authenticated customer\u0027s order history (paginated)." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Orders fetched successfully\",\n \"data\": {\n \"current_page\": 1,\n \"data\": [\n {\n \"id\": 1,\n \"status\": \"pending\",\n \"total\": 70.00,\n \"delivery_date\": \"2026-05-14\",\n \"payment_method\": \"cod\",\n \"created_at\": \"2026-05-13T12:00:00.000000Z\"\n },\n {\n \"id\": 2,\n \"status\": \"delivered\",\n \"total\": 45.00,\n \"delivery_date\": \"2026-05-12\",\n \"payment_method\": \"online\",\n \"created_at\": \"2026-05-11T15:30:00.000000Z\"\n }\n ],\n \"first_page_url\": \"http://127.0.0.1:8000/api/customer/orders?page=1\",\n \"from\": 1,\n \"last_page\": 1,\n \"last_page_url\": \"http://127.0.0.1:8000/api/customer/orders?page=1\",\n \"next_page_url\": null,\n \"path\": \"http://127.0.0.1:8000/api/customer/orders\",\n \"per_page\": 15,\n \"prev_page_url\": null,\n \"to\": 2,\n \"total\": 2\n }\n}" } ] }, { "name": "Get Order", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "url": { "raw": "{{base_url}}/api/customer/orders/1", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "orders", "1" ] }, "description": "Get full details of a specific order (must belong to the authenticated customer)." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Order fetched successfully\",\n \"data\": {\n \"order\": {\n \"id\": 1,\n \"status\": \"pending\",\n \"subtotal\": 60.00,\n \"delivery_fee\": 10.00,\n \"total\": 70.00,\n \"payment_method\": \"cod\",\n \"delivery_date\": \"2026-05-14\",\n \"notes\": \"Please leave at the door\",\n \"address\": {\n \"id\": 1,\n \"title\": \"Home\",\n \"address\": \"15 El-Tahrir Street, Downtown, Cairo\",\n \"lat\": 30.044420,\n \"lng\": 31.235712\n },\n \"driver\": null,\n \"scheduled_time\": {\n \"id\": 1,\n \"label\": \"Morning 9AM-12PM\",\n \"time_from\": \"09:00:00\",\n \"time_to\": \"12:00:00\"\n },\n \"promo_code\": null,\n \"items\": [\n {\n \"id\": 1,\n \"product_id\": 1,\n \"bundle_id\": null,\n \"title\": \"Water Bottle 1.5L\",\n \"price\": 10.00,\n \"image\": \"http://127.0.0.1:8000/storage/products/bottle-1.5l.jpg\",\n \"quantity\": 6,\n \"unit_price\": 10.00,\n \"subtotal\": 60.00\n }\n ]\n }\n }\n}" }, { "name": "Not Found", "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": false,\n \"message\": \"Not found\"\n}" } ] }, { "name": "Place Order", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "key": "Authorization", "value": "Bearer {{token}}" } ], "body": { "mode": "raw", "raw": "{\n \"address_id\": 1,\n \"delivery_date\": \"2026-05-14\",\n \"scheduled_time_id\": 1,\n \"payment_method\": \"cod\",\n \"promo_code\": \"SAVE10\",\n \"notes\": \"Please leave at the door\"\n}" }, "url": { "raw": "{{base_url}}/api/customer/orders", "host": [ "{{base_url}}" ], "path": [ "api", "customer", "orders" ] }, "description": "Place a new order using the customer\u0027s cart items. The cart must have items. Calculates subtotal, applies promo code if valid, adds delivery fee of 10.00 EGP, then clears the cart." }, "response": [ { "name": "Success", "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": true,\n \"message\": \"Order created successfully\",\n \"data\": {\n \"order\": {\n \"id\": 1,\n \"status\": \"pending\",\n \"subtotal\": 60.00,\n \"delivery_fee\": 10.00,\n \"total\": 64.00,\n \"payment_method\": \"cod\",\n \"delivery_date\": \"2026-05-14\",\n \"notes\": \"Please leave at the door\",\n \"address\": {\n \"id\": 1,\n \"title\": \"Home\",\n \"address\": \"15 El-Tahrir Street, Downtown, Cairo\",\n \"lat\": 30.044420,\n \"lng\": 31.235712\n },\n \"driver\": null,\n \"scheduled_time\": {\n \"id\": 1,\n \"label\": \"Morning 9AM-12PM\",\n \"time_from\": \"09:00:00\",\n \"time_to\": \"12:00:00\"\n },\n \"promo_code\": {\n \"code\": \"SAVE10\",\n \"type\": \"percent\",\n \"discount\": 10.00\n },\n \"items\": [\n {\n \"id\": 1,\n \"product_id\": 1,\n \"bundle_id\": null,\n \"title\": \"Water Bottle 1.5L\",\n \"price\": 10.00,\n \"image\": \"http://127.0.0.1:8000/storage/products/bottle-1.5l.jpg\",\n \"quantity\": 6,\n \"unit_price\": 10.00,\n \"subtotal\": 60.00\n }\n ]\n }\n }\n}" }, { "name": "Empty Cart", "status": "Unprocessable Entity", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": false,\n \"message\": \"Cart is empty\"\n}" } ] } ], "description": "Protected endpoints for managing orders." } ] }