{ "info": { "_postman_id": "rfoof-collection-001", "name": "Rfoof API", "description": "Rofoof Shopping Marketplace API - UAE.\n\nFirebase Phone Auth → JWT. Supports English/Arabic via Accept-Language header.\n\nAuth: Bearer token in Authorization header.\nLocalization: Accept-Language: en | ar", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{access_token}}", "type": "string" } ] }, "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "exec": [ "" ] } } ], "variable": [], "item": [ { "name": "Auth", "item": [ { "name": "Firebase Login", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/auth/firebase/", "host": [ "{{base_url}}" ], "path": [ "auth", "firebase", "" ] }, "body": { "mode": "raw", "raw": "{\n \"id_token\": \"{{firebase_id_token}}\"\n}" }, "auth": { "type": "noauth" } }, "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "var jsonData = pm.response.json();", "if (jsonData.data && jsonData.data.access) {", " pm.environment.set('access_token', jsonData.data.access);", " pm.environment.set('refresh_token', jsonData.data.refresh);", "}" ] } } ] }, { "name": "Refresh Token", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/auth/refresh/", "host": [ "{{base_url}}" ], "path": [ "auth", "refresh", "" ] }, "body": { "mode": "raw", "raw": "{\n \"refresh\": \"{{refresh_token}}\"\n}" }, "auth": { "type": "noauth" } }, "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "var jsonData = pm.response.json();", "var d = jsonData.data || jsonData;", "if (d.access) {", " pm.environment.set('access_token', d.access);", "}", "if (d.refresh) {", " pm.environment.set('refresh_token', d.refresh);", "}" ] } } ] }, { "name": "Logout", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/auth/logout/", "host": [ "{{base_url}}" ], "path": [ "auth", "logout", "" ] }, "body": { "mode": "raw", "raw": "{\n \"refresh\": \"{{refresh_token}}\"\n}" } } }, { "name": "Get Profile (me)", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/auth/me/", "host": [ "{{base_url}}" ], "path": [ "auth", "me", "" ] } } }, { "name": "Update Profile (me)", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/auth/me/", "host": [ "{{base_url}}" ], "path": [ "auth", "me", "" ] }, "body": { "mode": "raw", "raw": "{\n \"full_name\": \"John Doe\",\n \"email\": \"john@example.com\",\n \"language\": \"en\",\n \"customer_type\": \"customer\",\n \"notifications_enabled\": true\n}" } } }, { "name": "Delete Account (me)", "request": { "method": "DELETE", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/auth/me/", "host": [ "{{base_url}}" ], "path": [ "auth", "me", "" ] } } }, { "name": "Check App Review Status", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/auth/app-review/", "host": [ "{{base_url}}" ], "path": [ "auth", "app-review", "" ] } } }, { "name": "Mark App Reviewed", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/auth/app-review/", "host": [ "{{base_url}}" ], "path": [ "auth", "app-review", "" ] } } } ] }, { "name": "Admin Auth (Djoser)", "item": [ { "name": "Admin JWT Login", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/auth/admin/jwt/create/", "host": [ "{{base_url}}" ], "path": [ "auth", "admin", "jwt", "create", "" ] }, "body": { "mode": "raw", "raw": "{\n \"email\": \"{{admin_email}}\",\n \"password\": \"{{admin_password}}\"\n}" }, "auth": { "type": "noauth" } }, "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "var jsonData = pm.response.json();", "var d = jsonData.data || jsonData;", "if (d.access) {", " pm.environment.set('access_token', d.access);", "}", "if (d.refresh) {", " pm.environment.set('refresh_token', d.refresh);", "}" ] } } ] }, { "name": "Admin JWT Refresh", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/auth/admin/jwt/refresh/", "host": [ "{{base_url}}" ], "path": [ "auth", "admin", "jwt", "refresh", "" ] }, "body": { "mode": "raw", "raw": "{\n \"refresh\": \"{{refresh_token}}\"\n}" }, "auth": { "type": "noauth" } }, "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "var jsonData = pm.response.json();", "var d = jsonData.data || jsonData;", "if (d.access) {", " pm.environment.set('access_token', d.access);", "}", "if (d.refresh) {", " pm.environment.set('refresh_token', d.refresh);", "}" ] } } ] } ] }, { "name": "Core", "item": [ { "name": "Health Check", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/health/", "host": [ "{{base_url}}" ], "path": [ "health", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Home Feed (Guest)", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/home/guest/", "host": [ "{{base_url}}" ], "path": [ "home", "guest", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Home Feed (Authenticated)", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/home/", "host": [ "{{base_url}}" ], "path": [ "home", "" ] } } }, { "name": "Global Search", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/search/?q=coffee", "host": [ "{{base_url}}" ], "path": [ "search", "" ], "query": [ { "key": "q", "value": "coffee" } ] }, "auth": { "type": "noauth" } } }, { "name": "App Version Check", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/app-version/?platform=ios", "host": [ "{{base_url}}" ], "path": [ "app-version", "" ], "query": [ { "key": "platform", "value": "ios" } ] }, "auth": { "type": "noauth" } } }, { "name": "App Version Update (Admin)", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/app-version/update/", "host": [ "{{base_url}}" ], "path": [ "app-version", "update", "" ] }, "body": { "mode": "raw", "raw": "{\n \"platform\": \"ios\",\n \"latest_version\": \"2.0.0\",\n \"minimum_version\": \"1.5.0\",\n \"is_force_update\": false,\n \"update_url\": \"https://apps.apple.com/app/rfoof\",\n \"release_notes_en\": \"Bug fixes\",\n \"release_notes_ar\": \"إصلاح أخطاء\"\n}" } } }, { "name": "About Page", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/about/", "host": [ "{{base_url}}" ], "path": [ "about", "" ] }, "auth": { "type": "noauth" } } }, { "name": "About Page Update (Admin)", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/about/update_about/", "host": [ "{{base_url}}" ], "path": [ "about", "update_about", "" ] }, "body": { "mode": "raw", "raw": "{\n \"content_en\": \"About Rofoof...\",\n \"content_ar\": \"حول رفوف...\",\n \"version_label\": \"1.0.0\",\n \"build_info\": \"Build 100\",\n \"copyright_text\": \"© 2024 Rofoof\"\n}" } } }, { "name": "Terms & Conditions", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/terms/", "host": [ "{{base_url}}" ], "path": [ "terms", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Terms Update (Admin)", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/terms/update/", "host": [ "{{base_url}}" ], "path": [ "terms", "update", "" ] }, "body": { "mode": "raw", "raw": "{\n \"content_en\": \"Terms and Conditions...\",\n \"content_ar\": \"الشروط والأحكام...\",\n \"version_label\": \"1.0\"\n}" } } }, { "name": "Support Contact", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/support/", "host": [ "{{base_url}}" ], "path": [ "support", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Support Contact Update (Admin)", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/support/update_contact/", "host": [ "{{base_url}}" ], "path": [ "support", "update_contact", "" ] }, "body": { "mode": "raw", "raw": "{\n \"whatsapp_number\": \"+971501234567\",\n \"instagram_handle\": \"@rfoof\",\n \"chat_url\": \"https://chat.rfoof.online\",\n \"phone_number\": \"+971501234567\",\n \"email\": \"support@rfoof.online\"\n}" } } } ] }, { "name": "Banners", "item": [ { "name": "List Banners", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/banners/?", "host": [ "{{base_url}}" ], "path": [ "banners", "" ], "query": [ { "key": "placement", "value": "home_top", "disabled": true }, { "key": "is_active", "value": "true", "disabled": true }, { "key": "search", "value": "", "disabled": true }, { "key": "ordering", "value": "display_order", "disabled": true } ] }, "auth": { "type": "noauth" } } }, { "name": "Get Banner", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/banners/{{banner_id}}", "host": [ "{{base_url}}" ], "path": [ "banners", "{{banner_id}}", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Create Banner (Admin)", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/banners/", "host": [ "{{base_url}}" ], "path": [ "banners", "" ] }, "body": { "mode": "formdata", "formdata": [ { "key": "title_en", "value": "Big Sale", "type": "text" }, { "key": "title_ar", "value": "تخفيضات كبيرة", "type": "text" }, { "key": "subtitle_en", "value": "Up to 50% off", "type": "text" }, { "key": "subtitle_ar", "value": "خصم يصل إلى 50%", "type": "text" }, { "key": "cta_text_en", "value": "Shop Now", "type": "text" }, { "key": "cta_text_ar", "value": "تسوق الآن", "type": "text" }, { "key": "cta_url", "value": "https://rfoof.online/sale", "type": "text" }, { "key": "placement", "value": "home_top", "type": "text" }, { "key": "display_order", "value": "1", "type": "text" }, { "key": "is_active", "value": "true", "type": "text" }, { "key": "image", "type": "file", "src": "" } ] } } }, { "name": "Update Banner (Admin)", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/banners/{{banner_id}}", "host": [ "{{base_url}}" ], "path": [ "banners", "{{banner_id}}", "" ] }, "body": { "mode": "raw", "raw": "{\n \"title_en\": \"Updated Banner\",\n \"is_active\": true\n}" } } }, { "name": "Delete Banner (Admin)", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/banners/{{banner_id}}", "host": [ "{{base_url}}" ], "path": [ "banners", "{{banner_id}}", "" ] } } } ] }, { "name": "Categories", "item": [ { "name": "List Categories", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/categories/", "host": [ "{{base_url}}" ], "path": [ "categories", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Get Category", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/categories/{{category_id}}", "host": [ "{{base_url}}" ], "path": [ "categories", "{{category_id}}", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Category Stores", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/categories/{{category_id}}/stores/", "host": [ "{{base_url}}" ], "path": [ "categories", "{{category_id}}", "stores", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Create Category (Admin)", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/categories/", "host": [ "{{base_url}}" ], "path": [ "categories", "" ] }, "body": { "mode": "formdata", "formdata": [ { "key": "name_en", "value": "Electronics", "type": "text" }, { "key": "name_ar", "value": "إلكترونيات", "type": "text" }, { "key": "icon", "type": "file", "src": "" } ] } } }, { "name": "Update Category (Admin)", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/categories/{{category_id}}", "host": [ "{{base_url}}" ], "path": [ "categories", "{{category_id}}", "" ] }, "body": { "mode": "raw", "raw": "{\n \"name_en\": \"Updated Category\"\n}" } } }, { "name": "Delete Category (Admin)", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/categories/{{category_id}}", "host": [ "{{base_url}}" ], "path": [ "categories", "{{category_id}}", "" ] } } } ] }, { "name": "Stores", "item": [ { "name": "List Stores", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/stores/?", "host": [ "{{base_url}}" ], "path": [ "stores", "" ], "query": [ { "key": "search", "value": "", "disabled": true }, { "key": "category", "value": "", "disabled": true }, { "key": "is_online", "value": "true", "disabled": true }, { "key": "is_in_store", "value": "true", "disabled": true }, { "key": "has_deals", "value": "true", "disabled": true }, { "key": "ordering", "value": "-created_at", "disabled": true }, { "key": "page", "value": "1", "disabled": true } ] }, "auth": { "type": "noauth" } } }, { "name": "Get Store", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/stores/{{store_id}}", "host": [ "{{base_url}}" ], "path": [ "stores", "{{store_id}}", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Top Stores", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/stores/top/", "host": [ "{{base_url}}" ], "path": [ "stores", "top", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Recommended Stores", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/stores/recommended/", "host": [ "{{base_url}}" ], "path": [ "stores", "recommended", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Recently Added Stores", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/stores/recently-added/", "host": [ "{{base_url}}" ], "path": [ "stores", "recently-added", "" ] }, "auth": { "type": "noauth" } } }, { "name": "My Stores", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/stores/mine/", "host": [ "{{base_url}}" ], "path": [ "stores", "mine", "" ] } } }, { "name": "Create Store", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/stores/", "host": [ "{{base_url}}" ], "path": [ "stores", "" ] }, "body": { "mode": "formdata", "formdata": [ { "key": "name_en", "value": "My Store", "type": "text" }, { "key": "name_ar", "value": "متجري", "type": "text" }, { "key": "description_en", "value": "A great store", "type": "text" }, { "key": "description_ar", "value": "متجر رائع", "type": "text" }, { "key": "whatsapp_link", "value": "https://wa.me/971501234567", "type": "text" }, { "key": "instagram_link", "value": "https://instagram.com/mystore", "type": "text" }, { "key": "is_online", "value": "true", "type": "text" }, { "key": "is_in_store", "value": "false", "type": "text" }, { "key": "local_delivery_days", "value": "3", "type": "text" }, { "key": "intl_delivery_days", "value": "7", "type": "text" }, { "key": "categories", "value": "1", "type": "text" }, { "key": "logo", "type": "file", "src": "" }, { "key": "cover", "type": "file", "src": "" } ] } } }, { "name": "Update Store", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/stores/{{store_id}}", "host": [ "{{base_url}}" ], "path": [ "stores", "{{store_id}}", "" ] }, "body": { "mode": "raw", "raw": "{\n \"name_en\": \"Updated Store Name\",\n \"description_en\": \"Updated description\"\n}" } } }, { "name": "Delete Store", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/stores/{{store_id}}", "host": [ "{{base_url}}" ], "path": [ "stores", "{{store_id}}", "" ] } } }, { "name": "List Branches", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/stores/{{store_id}}/branches/", "host": [ "{{base_url}}" ], "path": [ "stores", "{{store_id}}", "branches", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Add Branch", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/stores/{{store_id}}/branches/", "host": [ "{{base_url}}" ], "path": [ "stores", "{{store_id}}", "branches", "" ] }, "body": { "mode": "raw", "raw": "{\n \"address\": \"Dubai Mall, Ground Floor\",\n \"latitude\": 25.1972,\n \"longitude\": 55.2796,\n \"is_open\": true,\n \"open_hours\": \"9:00 AM - 10:00 PM\"\n}" } } }, { "name": "Update Branch", "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/stores/{{store_id}}/branches/{{branch_id}}", "host": [ "{{base_url}}" ], "path": [ "stores", "{{store_id}}", "branches", "{{branch_id}}", "" ] }, "body": { "mode": "raw", "raw": "{\n \"address\": \"Updated Address\",\n \"latitude\": 25.1972,\n \"longitude\": 55.2796,\n \"is_open\": true,\n \"open_hours\": \"10:00 AM - 9:00 PM\"\n}" } } }, { "name": "Delete Branch", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/stores/{{store_id}}/branches/{{branch_id}}", "host": [ "{{base_url}}" ], "path": [ "stores", "{{store_id}}", "branches", "{{branch_id}}", "" ] } } }, { "name": "List Reviews", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/stores/{{store_id}}/reviews/", "host": [ "{{base_url}}" ], "path": [ "stores", "{{store_id}}", "reviews", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Submit Review", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/stores/{{store_id}}/reviews/", "host": [ "{{base_url}}" ], "path": [ "stores", "{{store_id}}", "reviews", "" ] }, "body": { "mode": "raw", "raw": "{\n \"rating\": 5,\n \"title\": \"Great store!\",\n \"comment\": \"Loved the products and fast delivery.\"\n}" } } } ] }, { "name": "Products", "item": [ { "name": "List Products", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/products/?", "host": [ "{{base_url}}" ], "path": [ "products", "" ], "query": [ { "key": "store", "value": "", "disabled": true }, { "key": "category", "value": "", "disabled": true }, { "key": "is_featured", "value": "true", "disabled": true }, { "key": "has_discount", "value": "true", "disabled": true }, { "key": "min_price", "value": "", "disabled": true }, { "key": "max_price", "value": "", "disabled": true }, { "key": "search", "value": "", "disabled": true }, { "key": "ordering", "value": "-created_at", "disabled": true }, { "key": "page", "value": "1", "disabled": true } ] }, "auth": { "type": "noauth" } } }, { "name": "Get Product", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/products/{{product_id}}", "host": [ "{{base_url}}" ], "path": [ "products", "{{product_id}}", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Great Offers", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/products/great-offers/", "host": [ "{{base_url}}" ], "path": [ "products", "great-offers", "" ] }, "auth": { "type": "noauth" } } }, { "name": "My Products", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/products/mine/", "host": [ "{{base_url}}" ], "path": [ "products", "mine", "" ] } } }, { "name": "Create Product", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/products/", "host": [ "{{base_url}}" ], "path": [ "products", "" ] }, "body": { "mode": "formdata", "formdata": [ { "key": "store", "value": "{{store_id}}", "type": "text" }, { "key": "category", "value": "{{category_id}}", "type": "text" }, { "key": "name_en", "value": "Product Name", "type": "text" }, { "key": "name_ar", "value": "اسم المنتج", "type": "text" }, { "key": "description_en", "value": "Product description", "type": "text" }, { "key": "description_ar", "value": "وصف المنتج", "type": "text" }, { "key": "price", "value": "99.99", "type": "text" }, { "key": "original_price", "value": "149.99", "type": "text" }, { "key": "discount_percent", "value": "33", "type": "text" }, { "key": "is_featured", "value": "false", "type": "text" }, { "key": "image", "type": "file", "src": "" } ] } } }, { "name": "Update Product", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/products/{{product_id}}", "host": [ "{{base_url}}" ], "path": [ "products", "{{product_id}}", "" ] }, "body": { "mode": "raw", "raw": "{\n \"name_en\": \"Updated Product\",\n \"price\": 79.99\n}" } } }, { "name": "Delete Product", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/products/{{product_id}}", "host": [ "{{base_url}}" ], "path": [ "products", "{{product_id}}", "" ] } } } ] }, { "name": "Events", "item": [ { "name": "List Events", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/events/?", "host": [ "{{base_url}}" ], "path": [ "events", "" ], "query": [ { "key": "search", "value": "", "disabled": true }, { "key": "is_active", "value": "true", "disabled": true }, { "key": "start_date_after", "value": "2024-01-01", "disabled": true }, { "key": "start_date_before", "value": "2025-12-31", "disabled": true }, { "key": "ordering", "value": "-start_date", "disabled": true } ] }, "auth": { "type": "noauth" } } }, { "name": "Get Event", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/events/{{event_id}}", "host": [ "{{base_url}}" ], "path": [ "events", "{{event_id}}", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Event Stores", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/events/{{event_id}}/stores/?", "host": [ "{{base_url}}" ], "path": [ "events", "{{event_id}}", "stores", "" ], "query": [ { "key": "search", "value": "", "disabled": true } ] }, "auth": { "type": "noauth" } } }, { "name": "Create Event (Admin)", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/events/", "host": [ "{{base_url}}" ], "path": [ "events", "" ] }, "body": { "mode": "formdata", "formdata": [ { "key": "name_en", "value": "Summer Sale Event", "type": "text" }, { "key": "name_ar", "value": "حدث التخفيضات الصيفية", "type": "text" }, { "key": "description_en", "value": "Annual summer sale", "type": "text" }, { "key": "description_ar", "value": "تخفيضات الصيف السنوية", "type": "text" }, { "key": "start_date", "value": "2025-06-01", "type": "text" }, { "key": "end_date", "value": "2025-06-30", "type": "text" }, { "key": "venue_name", "value": "Dubai Mall", "type": "text" }, { "key": "address", "value": "Dubai, UAE", "type": "text" }, { "key": "latitude", "value": "25.1972", "type": "text" }, { "key": "longitude", "value": "55.2796", "type": "text" }, { "key": "cover", "type": "file", "src": "" }, { "key": "logo", "type": "file", "src": "" } ] } } }, { "name": "Update Event (Admin)", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/events/{{event_id}}", "host": [ "{{base_url}}" ], "path": [ "events", "{{event_id}}", "" ] }, "body": { "mode": "raw", "raw": "{\n \"name_en\": \"Updated Event\"\n}" } } }, { "name": "Delete Event (Admin)", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/events/{{event_id}}", "host": [ "{{base_url}}" ], "path": [ "events", "{{event_id}}", "" ] } } } ] }, { "name": "Engagement", "item": [ { "name": "List Favorites", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/favorites/?", "host": [ "{{base_url}}" ], "path": [ "favorites", "" ], "query": [ { "key": "search", "value": "", "disabled": true }, { "key": "deals", "value": "true", "disabled": true }, { "key": "installments", "value": "true", "disabled": true }, { "key": "online", "value": "true", "disabled": true }, { "key": "in_store", "value": "true", "disabled": true } ] } } }, { "name": "Add Favorite", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/favorites/", "host": [ "{{base_url}}" ], "path": [ "favorites", "" ] }, "body": { "mode": "raw", "raw": "{\n \"store_id\": {{store_id}}\n}" } } }, { "name": "Remove Favorite", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/favorites/{{store_id}}", "host": [ "{{base_url}}" ], "path": [ "favorites", "{{store_id}}", "" ] } } }, { "name": "List Recently Viewed", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/recently-viewed/", "host": [ "{{base_url}}" ], "path": [ "recently-viewed", "" ] } } }, { "name": "Record Store View", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/recently-viewed/", "host": [ "{{base_url}}" ], "path": [ "recently-viewed", "" ] }, "body": { "mode": "raw", "raw": "{\n \"store_id\": {{store_id}}\n}" } } }, { "name": "List Coupons", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/coupons/?", "host": [ "{{base_url}}" ], "path": [ "coupons", "" ], "query": [ { "key": "store", "value": "{{store_id}}", "disabled": true } ] }, "auth": { "type": "noauth" } } }, { "name": "Get Coupon", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/coupons/{{coupon_id}}", "host": [ "{{base_url}}" ], "path": [ "coupons", "{{coupon_id}}", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Create Coupon (Admin)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/coupons/", "host": [ "{{base_url}}" ], "path": [ "coupons", "" ] }, "body": { "mode": "raw", "raw": "{\n \"code\": \"SUMMER2025\",\n \"discount_percent\": 20,\n \"discount_amount\": null,\n \"valid_from\": \"2025-06-01T00:00:00Z\",\n \"valid_until\": \"2025-08-31T23:59:59Z\",\n \"store\": {{store_id}},\n \"is_active\": true\n}" } } }, { "name": "Update Coupon (Admin)", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/coupons/{{coupon_id}}", "host": [ "{{base_url}}" ], "path": [ "coupons", "{{coupon_id}}", "" ] }, "body": { "mode": "raw", "raw": "{\n \"is_active\": false\n}" } } }, { "name": "Delete Coupon (Admin)", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/coupons/{{coupon_id}}", "host": [ "{{base_url}}" ], "path": [ "coupons", "{{coupon_id}}", "" ] } } }, { "name": "List Notifications", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/notifications/", "host": [ "{{base_url}}" ], "path": [ "notifications", "" ] } } }, { "name": "Unread Count", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/notifications/unread-count/", "host": [ "{{base_url}}" ], "path": [ "notifications", "unread-count", "" ] } } }, { "name": "Mark as Read", "request": { "method": "PATCH", "header": [], "url": { "raw": "{{base_url}}/notifications/{{notification_id}}/read/", "host": [ "{{base_url}}" ], "path": [ "notifications", "{{notification_id}}", "read", "" ] } } }, { "name": "Mark All as Read", "request": { "method": "PATCH", "header": [], "url": { "raw": "{{base_url}}/notifications/read-all/", "host": [ "{{base_url}}" ], "path": [ "notifications", "read-all", "" ] } } }, { "name": "Notification Settings", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/notifications/settings/", "host": [ "{{base_url}}" ], "path": [ "notifications", "settings", "" ] }, "body": { "mode": "raw", "raw": "{\n \"notifications_enabled\": true\n}" } } }, { "name": "Create Notification (Admin)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/notifications/", "host": [ "{{base_url}}" ], "path": [ "notifications", "" ] }, "body": { "mode": "raw", "raw": "{\n \"user\": 1,\n \"title\": \"Welcome!\",\n \"body\": \"Thanks for joining Rofoof\",\n \"type\": \"general\",\n \"image\": null\n}" } } } ] }, { "name": "Referrals", "item": [ { "name": "My Referral Code", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/referrals/my-code/", "host": [ "{{base_url}}" ], "path": [ "referrals", "my-code", "" ] } } }, { "name": "Apply Referral Code", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/referrals/apply/", "host": [ "{{base_url}}" ], "path": [ "referrals", "apply", "" ] }, "body": { "mode": "raw", "raw": "{\n \"code\": \"ABC123\"\n}" } } }, { "name": "Referral History", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/referrals/history/", "host": [ "{{base_url}}" ], "path": [ "referrals", "history", "" ] } } }, { "name": "Points Balance", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/referrals/points/", "host": [ "{{base_url}}" ], "path": [ "referrals", "points", "" ] } } }, { "name": "List All Referrals (Admin)", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/admin/referrals/", "host": [ "{{base_url}}" ], "path": [ "admin", "referrals", "" ] } } }, { "name": "Get Referral (Admin)", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/admin/referrals/1/", "host": [ "{{base_url}}" ], "path": [ "admin", "referrals", "1", "" ] } } } ] }, { "name": "Promotions", "item": [ { "name": "List Promotion Plans", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/promotion-plans/", "host": [ "{{base_url}}" ], "path": [ "promotion-plans", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Get Promotion Plan", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/promotion-plans/{{promotion_plan_id}}", "host": [ "{{base_url}}" ], "path": [ "promotion-plans", "{{promotion_plan_id}}", "" ] }, "auth": { "type": "noauth" } } }, { "name": "Create Promotion Plan (Admin)", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/promotion-plans/", "host": [ "{{base_url}}" ], "path": [ "promotion-plans", "" ] }, "body": { "mode": "raw", "raw": "{\n \"name_en\": \"Gold Store Plan\",\n \"name_ar\": \"خطة المتجر الذهبية\",\n \"type\": \"store\",\n \"duration_months\": 3,\n \"price\": 299.00,\n \"is_active\": true\n}" } } }, { "name": "Update Promotion Plan (Admin)", "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/promotion-plans/{{promotion_plan_id}}", "host": [ "{{base_url}}" ], "path": [ "promotion-plans", "{{promotion_plan_id}}", "" ] }, "body": { "mode": "raw", "raw": "{\n \"price\": 249.00\n}" } } }, { "name": "Delete Promotion Plan (Admin)", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/promotion-plans/{{promotion_plan_id}}", "host": [ "{{base_url}}" ], "path": [ "promotion-plans", "{{promotion_plan_id}}", "" ] } } }, { "name": "List My Promotions", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/promotions/mine/", "host": [ "{{base_url}}" ], "path": [ "promotions", "mine", "" ] } } }, { "name": "Create Promotion", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/promotions/", "host": [ "{{base_url}}" ], "path": [ "promotions", "" ] }, "body": { "mode": "raw", "raw": "{\n \"store\": {{store_id}},\n \"product\": null,\n \"plan\": {{promotion_plan_id}}\n}" }, "description": "Creates a promotion (pending) and returns a MyFatoorah payment_url. Redirect user there to pay." } }, { "name": "Confirm Payment", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/promotions/{{promotion_id}}/confirm-payment/", "host": [ "{{base_url}}" ], "path": [ "promotions", "{{promotion_id}}", "confirm-payment", "" ] }, "description": "Call after user completes payment on MyFatoorah. Activates the promotion." } }, { "name": "List All Promotions (Admin)", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/promotions/", "host": [ "{{base_url}}" ], "path": [ "promotions", "" ] } } } ] }, { "name": "Analytics", "item": [ { "name": "Track Single Event", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/analytics/track/", "host": [ "{{base_url}}" ], "path": [ "analytics", "track", "" ] }, "body": { "mode": "raw", "raw": "{\n \"event_type\": \"screen_view\",\n \"event_name\": \"home_opened\",\n \"screen_name\": \"home\",\n \"target_type\": \"\",\n \"target_id\": \"\",\n \"target_name\": \"\",\n \"metadata\": {},\n \"session_id\": \"sess_abc123\",\n \"session_duration\": null,\n \"platform\": \"ios\",\n \"app_version\": \"1.2.0\",\n \"os_version\": \"17.5\",\n \"device_model\": \"iPhone 15\",\n \"screen_resolution\": \"1179x2556\",\n \"device_id\": \"device_uuid_here\",\n \"latitude\": 25.1972,\n \"longitude\": 55.2796,\n \"city\": \"Dubai\",\n \"country\": \"AE\",\n \"connection_type\": \"wifi\",\n \"client_timestamp\": \"2025-06-21T10:30:00Z\"\n}" }, "description": "Send a single user behavior event. Works for both authenticated and guest users." } }, { "name": "Track Batch Events", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/analytics/batch/", "host": [ "{{base_url}}" ], "path": [ "analytics", "batch", "" ] }, "body": { "mode": "raw", "raw": "{\n \"events\": [\n {\n \"event_type\": \"screen_view\",\n \"screen_name\": \"home\",\n \"device_id\": \"device_uuid_here\",\n \"session_id\": \"sess_abc123\",\n \"platform\": \"ios\",\n \"app_version\": \"1.2.0\",\n \"client_timestamp\": \"2025-06-21T10:30:00Z\"\n },\n {\n \"event_type\": \"store_view\",\n \"screen_name\": \"store_detail\",\n \"target_type\": \"store\",\n \"target_id\": \"5\",\n \"target_name\": \"Coffee House\",\n \"device_id\": \"device_uuid_here\",\n \"session_id\": \"sess_abc123\",\n \"platform\": \"ios\",\n \"app_version\": \"1.2.0\",\n \"client_timestamp\": \"2025-06-21T10:31:00Z\"\n },\n {\n \"event_type\": \"favorite_add\",\n \"screen_name\": \"store_detail\",\n \"target_type\": \"store\",\n \"target_id\": \"5\",\n \"device_id\": \"device_uuid_here\",\n \"session_id\": \"sess_abc123\",\n \"platform\": \"ios\",\n \"app_version\": \"1.2.0\",\n \"client_timestamp\": \"2025-06-21T10:31:30Z\"\n }\n ]\n}" }, "description": "Send multiple events at once (recommended for performance). Batch up events and send periodically." } }, { "name": "Report Session", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{base_url}}/analytics/session/", "host": [ "{{base_url}}" ], "path": [ "analytics", "session", "" ] }, "body": { "mode": "raw", "raw": "{\n \"session_id\": \"sess_abc123\",\n \"device_id\": \"device_uuid_here\",\n \"started_at\": \"2025-06-21T10:30:00Z\",\n \"ended_at\": \"2025-06-21T10:45:00Z\",\n \"duration_seconds\": 900,\n \"platform\": \"ios\",\n \"app_version\": \"1.2.0\",\n \"device_model\": \"iPhone 15\",\n \"screens_viewed\": 8,\n \"events_count\": 23\n}" }, "description": "Report a session start or end. Send again with ended_at to close the session." } }, { "name": "List Events (Admin)", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/admin/analytics/events/?", "host": [ "{{base_url}}" ], "path": [ "admin", "analytics", "events", "" ], "query": [ { "key": "user", "value": "", "disabled": true }, { "key": "event_type", "value": "screen_view", "disabled": true }, { "key": "screen_name", "value": "", "disabled": true }, { "key": "platform", "value": "ios", "disabled": true }, { "key": "target_type", "value": "store", "disabled": true }, { "key": "date_from", "value": "2025-06-01T00:00:00Z", "disabled": true }, { "key": "date_to", "value": "2025-06-30T23:59:59Z", "disabled": true }, { "key": "page", "value": "1", "disabled": true } ] } } }, { "name": "List Sessions (Admin)", "request": { "method": "GET", "header": [ { "key": "Accept-Language", "value": "{{language}}" } ], "url": { "raw": "{{base_url}}/admin/analytics/sessions/?", "host": [ "{{base_url}}" ], "path": [ "admin", "analytics", "sessions", "" ], "query": [ { "key": "user", "value": "", "disabled": true }, { "key": "platform", "value": "ios", "disabled": true }, { "key": "date_from", "value": "2025-06-01T00:00:00Z", "disabled": true }, { "key": "date_to", "value": "2025-06-30T23:59:59Z", "disabled": true }, { "key": "min_duration", "value": "60", "disabled": true }, { "key": "page", "value": "1", "disabled": true } ] } } }, { "name": "Dashboard Summary (Admin)", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/admin/analytics/dashboard/summary/", "host": [ "{{base_url}}" ], "path": [ "admin", "analytics", "dashboard", "summary", "" ] }, "description": "Overview: total events, sessions, active users, top screens, top events, daily chart." } }, { "name": "User Activity Timeline (Admin)", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/admin/analytics/dashboard/user-activity/?user_id=1", "host": [ "{{base_url}}" ], "path": [ "admin", "analytics", "dashboard", "user-activity", "" ], "query": [ { "key": "user_id", "value": "1" } ] }, "description": "Full behavior timeline for a specific user." } }, { "name": "Conversion Funnel (Admin)", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/admin/analytics/dashboard/funnel/?", "host": [ "{{base_url}}" ], "path": [ "admin", "analytics", "dashboard", "funnel", "" ], "query": [ { "key": "days", "value": "30", "disabled": true } ] }, "description": "Funnel: app_open → store_view → product_view → favorite → whatsapp → share" } } ] } ] }