{ "info": { "_postman_id": "mabany-api-collection-v2-1", "name": "Mabany Real Estate & Engineering API", "description": "# Mabany Real Estate & Engineering REST API\n\nWelcome to the official Postman Collection for consuming the Mabany REST API.\n\n## Overview\nThis collection provides full coverage for all public endpoints, localization options (`ar` / `en`), request parameter configurations, request body validation rules, and realistic response examples (Success 200/201, Not Found 404, Validation Error 422, Rate Limiting 429).\n\n## Environment Variables\n- `base_url`: Target server URL (e.g. `http://127.0.0.1:8000` or `http://mabany.test`)\n- `locale`: Active language (`ar` for Arabic, `en` for English)\n\n## Global Headers\n- `Accept`: `application/json`\n- `Accept-Language`: `{{locale}}`\n\n## Rate Limits\n- `POST /api/contact` is throttled to 6 submissions per minute per IP (`throttle:6,1`).", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "base_url", "value": "https://mabany.bondersmena.com", "type": "string", "description": "Target server API base URL" }, { "key": "locale", "value": "ar", "type": "string", "description": "Response language: ar (Arabic) or en (English)" } ], "item": [ { "name": "01 - General & Home", "description": "General endpoints including Home, About Us, Global Settings & Info, Privacy Policy, and Search.", "item": [ { "name": "GET Home Page Data", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/home", "host": [ "{{base_url}}" ], "path": [ "api", "home" ] }, "description": "Fetches unified data for the home page including hero slides, about section summary, statistics, mabany standards, featured solutions, featured projects, latest blogs, client logos, partner logos, testimonials, and SEO metadata." }, "response": [ { "name": "200 OK - Success (Home Data)", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"hero\": {\n \"id\": 1,\n \"title\": \"نبني المستقبل بأعلى معايير التميز الهندسي\",\n \"description\": \"رائدون في تقديم أفضل خدمات تطوير وإدارة المشاريع والحلول الإنشائية.\",\n \"video\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/hero\\/hero-video.mp4\"\n },\n \"about\": {\n \"title\": \"عن شركة مباني للتطوير والمقاولات\",\n \"description\": \"شركة مباني العالمية هي شركة رائدة في مجالات المقاولات العامة والحلول الهندسية.\",\n \"banner_image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/company\\/about.jpg\"\n },\n \"counters\": [\n {\n \"id\": 1,\n \"title\": \"سنوات من التميز والريادة\",\n \"number\": \"15+\",\n \"icon\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/stats\\/experience.png\"\n }\n ],\n \"standards\": [\n {\n \"title\": \"أعلى معايير السلامة\",\n \"description\": \"نلتزم بأعلى بروتوكولات السلامة في كافة مواقع العمل.\",\n \"icon\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/mabany-standards\\/safety.png\"\n }\n ],\n \"mep_solution\": {\n \"id\": 1,\n \"title\": \"مقاولات الأعمال الكهروميكانيكية (MEP)\",\n \"slug\": \"halul-mep\",\n \"other_slug\": \"mechanical-electrical-plumbing-mep\",\n \"description\": \"تقديم كافة أعمال الهندسة والتوريد والتركيب للأنظمة الكهروميكانيكية.\",\n \"main_image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/solutions\\/solution-1.jpg\"\n },\n \"other_solutions\": [],\n \"projects\": [],\n \"blogs\": [],\n \"clients\": [],\n \"partners\": [],\n \"testimonials\": [],\n \"seo\": {\n \"meta_title\": \"مباني - الرئيسية\",\n \"meta_description\": \"شركة مباني لتطوير وإدارة المشاريع الهندسية والإنشائية.\",\n \"og_image\": null\n }\n },\n \"errors\": null\n}" }, { "name": "500 Server Error", "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"message\": \"Server Error\",\n \"data\": null,\n \"errors\": \"Database connection failed\"\n}" } ] }, { "name": "GET About Us Page Data", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/about", "host": [ "{{base_url}}" ], "path": [ "api", "about" ] }, "description": "Fetches About Us page details including company history overview, statistics counters, client logos, partner logos, \"Why Choose Us\" block, and SEO metadata." }, "response": [ { "name": "200 OK - Success (About Data)", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"about\": {\n \"title\": \"عن شركة مباني للتطوير والمقاولات\",\n \"description\": \"شركة مباني العالمية هي شركة رائدة في مجالات المقاولات العامة والحلول الهندسية.\",\n \"banner_image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/company\\/about.jpg\"\n },\n \"counters\": [\n {\n \"id\": 1,\n \"title\": \"سنوات من التميز والريادة\",\n \"number\": \"15+\"\n }\n ],\n \"clients\": [],\n \"partners\": [],\n \"why_choose_us\": {\n \"title\": \"لماذا تختار مباني؟\",\n \"subtitle\": \"التميز والجودة والالتزام\",\n \"cards\": []\n },\n \"seo\": {\n \"meta_title\": \"عن مباني\",\n \"meta_description\": \"تعرف على شركة مباني وإنجازاتها في قطاع المقاولات.\"\n }\n },\n \"errors\": null\n}" } ] }, { "name": "GET System Settings & Info", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/info", "host": [ "{{base_url}}" ], "path": [ "api", "info" ] }, "description": "Fetches global company information including footer descriptions, main email, phone numbers, working hours, company profile PDF link, social media handles, and office branches." }, "response": [ { "name": "200 OK - Success (System Info)", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"footer_description\": \"شركة مباني العالمية لتطوير وإدارة المشاريع، نقدم أفضل الحلول الإنشائية الهندسية بأعلى معايير الجودة والأمان.\",\n \"social_media_links\": {\n \"linkedin\": \"https:\\/\\/linkedin.com\\/company\\/mabany\",\n \"facebook\": \"https:\\/\\/facebook.com\\/mabany\",\n \"instagram\": \"https:\\/\\/instagram.com\\/mabany\",\n \"twitter\": \"https:\\/\\/x.com\\/mabany\"\n },\n \"email\": \"info@mabany.com\",\n \"working_hours\": \"Sunday – Thursday: 08:00 AM – 05:00 PM\",\n \"company_profile\": null,\n \"branches\": [\n {\n \"id\": 1,\n \"name\": \"الفرع الرئيسي - الرياض\",\n \"address\": \"طريق الملك فهد، العليا، الرياض\",\n \"phone\": \"+966 11 234 5678\",\n \"map_link\": \"https:\\/\\/maps.google.com\\/?q=24.7136,46.6753\"\n }\n ]\n },\n \"errors\": null\n}" } ] }, { "name": "GET Global Search", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/search?q=MEP&page=1", "host": [ "{{base_url}}" ], "path": [ "api", "search" ], "query": [ { "key": "q", "value": "MEP", "description": "Search term (searches titles, descriptions, excerpts, and content in active language)" }, { "key": "page", "value": "1", "description": "Page number for manual pagination (9 results per page)" } ] }, "description": "Performs a unified search across Blogs, Projects, Solutions, and Industries. Filters items by the language specified in `Accept-Language` header (`ar` or `en`). Returns paginated results array." }, "response": [ { "name": "200 OK - Search Results Found", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"results\": [\n {\n \"id\": 1,\n \"type\": \"solution\",\n \"title\": \"مقاولات الأعمال الكهروميكانيكية (MEP)\",\n \"slug\": \"halul-mep\",\n \"other_slug\": \"mechanical-electrical-plumbing-mep\",\n \"description\": \"تقديم كافة أعمال الهندسة والتوريد والتركيب للأنظمة الكهروميكانيكية.\",\n \"image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/solutions\\/solution-1.jpg\"\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"per_page\": 9,\n \"current_page\": 1,\n \"last_page\": 1\n }\n },\n \"errors\": null\n}" }, { "name": "200 OK - Empty Query Results", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"results\": [],\n \"pagination\": null\n },\n \"errors\": null\n}" } ] }, { "name": "GET Privacy Policy", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/privacy-policy", "host": [ "{{base_url}}" ], "path": [ "api", "privacy-policy" ] }, "description": "Fetches the application Privacy Policy content and SEO metadata." }, "response": [ { "name": "200 OK - Success (Privacy Policy)", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"privacy_policy\": {\n \"title\": \"سياسة الخصوصية والاستخدام\",\n \"content\": \"

تلتزم شركة مباني بحماية خصوصية كافة المستخدمين والزوار...<\\/p>\"\n },\n \"seo\": {\n \"meta_title\": \"سياسة الخصوصية\",\n \"meta_description\": \"سياسة الخصوصية الخاصة بموقع شركة مباني.\"\n }\n },\n \"errors\": null\n}" } ] } ] }, { "name": "02 - Solutions", "description": "Endpoints for browsing Main Solutions, Sub-Solutions, Solution Details, and Solution Dropdown Types.", "item": [ { "name": "GET Solutions Index", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/solutions", "host": [ "{{base_url}}" ], "path": [ "api", "solutions" ] }, "description": "Returns list of main top-level solutions (`parent_id = null`) ordered by `order`. Includes `children_count` attribute returning active child solutions count, main image, titles, slugs, and SEO metadata." }, "response": [ { "name": "200 OK - Success (Solutions List)", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"solutions\": [\n {\n \"id\": 1,\n \"title\": \"مقاولات الأعمال الكهروميكانيكية (MEP)\",\n \"description\": \"تقديم كافة أعمال الهندسة والتوريد والتركيب والتشغيل للأنظمة الكهروميكانيكية.\",\n \"main_image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/solutions\\/solution-1.jpg\",\n \"slug\": \"halul-mep\",\n \"other_slug\": \"mechanical-electrical-plumbing-mep\",\n \"children_count\": 4\n }\n ],\n \"seo\": {\n \"meta_title\": \"حلول مباني الهندسية\",\n \"meta_description\": \"تصفح قائمة الحلول الإنشائية والهندسية المتكاملة.\"\n }\n },\n \"errors\": null\n}" } ] }, { "name": "GET Solution Details by Slug", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/solutions/:slug", "host": [ "{{base_url}}" ], "path": [ "api", "solutions", ":slug" ], "variable": [ { "key": "slug", "value": "mechanical-electrical-plumbing-mep", "description": "Solution slug in English or Arabic (e.g. `mechanical-electrical-plumbing-mep` or `halul-mep`)" } ] }, "description": "Fetches full solution details by slug. If the solution has children, returns `children` array. If it is a leaf solution, returns `standards`, `related_solutions`, and `related_projects`." }, "response": [ { "name": "200 OK - Solution Details (Parent Solution)", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"title\": \"Mechanical, Electrical & Plumbing (MEP)\",\n \"description\": \"Comprehensive MEP engineering, supply, installation, and commissioning for complex buildings.\",\n \"full_description\": \"Comprehensive MEP engineering, supply, installation, and commissioning for complex buildings. Our engineering team guarantees world-class quality.\",\n \"main_image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/solutions\\/solution-1.jpg\",\n \"slug\": \"mechanical-electrical-plumbing-mep\",\n \"other_slug\": \"halul-mep\",\n \"parent_id\": null,\n \"parent_slug\": null,\n \"other_parent_slug\": null,\n \"parent_title\": null,\n \"other_parent_title\": null,\n \"children\": [\n {\n \"title\": \"Central HVAC & Ventilation Systems\",\n \"description\": \"Complete heating, ventilation, and air conditioning solutions.\",\n \"main_image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/solutions\\/sub-1.jpg\",\n \"slug\": \"central-hvac-ventilation-systems\",\n \"other_slug\": \"halul-hvac\",\n \"parent_slug\": \"mechanical-electrical-plumbing-mep\",\n \"other_parent_slug\": \"halul-mep\",\n \"parent_title\": \"Mechanical, Electrical & Plumbing (MEP)\",\n \"other_parent_title\": \"\\u0645\\u0642\\u0627\\u0648\\u0644\\u0627\\u062a \\u0627\\u0644\\u0623\\u0639\\u0645\\u0627\\u0644 \\u0627\\u0644\\u0643\\u0647\\u0631\\u0648\\u0645\\u064a\\u0643\\u0627\\u0646\\u064a\\u0643\\u064a\\u0629 (MEP)\"\n }\n ],\n \"seo\": {\n \"meta_title\": \"Mechanical, Electrical & Plumbing (MEP)\",\n \"meta_description\": \"Comprehensive MEP engineering...\"\n }\n },\n \"errors\": null\n}" }, { "name": "404 Not Found - Solution Invalid Slug", "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"message\": \"Resource not found\",\n \"data\": null,\n \"errors\": null\n}" } ] }, { "name": "GET Child Solution Details", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/solutions/:parentSlug/:slug", "host": [ "{{base_url}}" ], "path": [ "api", "solutions", ":parentSlug", ":slug" ], "variable": [ { "key": "parentSlug", "value": "mechanical-electrical-plumbing-mep", "description": "Parent solution slug" }, { "key": "slug", "value": "central-hvac-ventilation-systems", "description": "Child solution slug" } ] }, "description": "Fetches child solution details using parent solution slug and child solution slug." }, "response": [ { "name": "200 OK - Child Solution Details", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"title\": \"Central HVAC & Ventilation Systems\",\n \"description\": \"Complete heating, ventilation, and air conditioning solutions.\",\n \"full_description\": \"Executed with specialized sub-contracting and technical engineering precision.\",\n \"main_image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/solutions\\/sub-1.jpg\",\n \"slug\": \"central-hvac-ventilation-systems\",\n \"other_slug\": \"halul-hvac\",\n \"parent_id\": 1,\n \"parent_slug\": \"mechanical-electrical-plumbing-mep\",\n \"other_parent_slug\": \"halul-mep\",\n \"parent_title\": \"Mechanical, Electrical & Plumbing (MEP)\",\n \"other_parent_title\": \"\\u0645\\u0642\\u0627\\u0648\\u0644\\u0627\\u062a \\u0627\\u0644\\u0623\\u0639\\u0645\\u0627\\u0644 \\u0627\\u0644\\u0643\\u0647\\u0631\\u0648\\u0645\\u064a\\u0643\\u0627\\u0646\\u064a\\u0643\\u064a\\u0629 (MEP)\",\n \"standards\": [],\n \"related_solutions\": [],\n \"related_projects\": [],\n \"seo\": {\n \"meta_title\": \"Central HVAC & Ventilation Systems\"\n }\n },\n \"errors\": null\n}" } ] }, { "name": "GET Solutions Dropdown List", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/solutions-types?per_page=10&page=1", "host": [ "{{base_url}}" ], "path": [ "api", "solutions-types" ], "query": [ { "key": "per_page", "value": "10", "description": "Items per page for pagination (default: 10)" }, { "key": "page", "value": "1", "description": "Current page number" } ] }, "description": "Returns a paginated list of active solutions (ID, title, slug) for populating select dropdowns and request quote forms." }, "response": [ { "name": "200 OK - Solutions Types List", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"solutions\": [\n {\n \"id\": 1,\n \"title\": \"Mechanical, Electrical & Plumbing (MEP)\",\n \"slug\": \"mechanical-electrical-plumbing-mep\"\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"per_page\": 10,\n \"current_page\": 1,\n \"last_page\": 1\n }\n },\n \"errors\": null\n}" } ] } ] }, { "name": "03 - Projects", "description": "Endpoints for retrieving Engineering Projects, Project Filtering by Industry, Project Details, and Project Types dropdown list.", "item": [ { "name": "GET Projects Index (with Industry Filter)", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/projects?type=commercial&page=1", "host": [ "{{base_url}}" ], "path": [ "api", "projects" ], "query": [ { "key": "type", "value": "commercial", "description": "Filter by industry slug or industry ID (e.g. `commercial`, `residential`, `1`, or `all`)" }, { "key": "page", "value": "1", "description": "Pagination page number (6 projects per page)" } ] }, "description": "Fetches paginated active projects list (6 per page). Supports filtering by industry using `type` parameter." }, "response": [ { "name": "200 OK - Success (Filtered Projects)", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"banner\": {\n \"title\": \"المشاريع الهندسية\",\n \"image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/banners\\/projects.jpg\"\n },\n \"company_profile_pdf\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/company\\/profile.pdf\",\n \"selected_type\": {\n \"id\": 1,\n \"title\": \"القطاع التجاري\",\n \"slug\": \"commercial\"\n },\n \"projects\": [\n {\n \"id\": 1,\n \"title\": \"برج الأعمال والمال المركزي بالرياض\",\n \"slug\": \"riyadh-financial-business-tower\",\n \"location\": \"طريق الملك فهد، الرياض\",\n \"completion_year\": \"2025\",\n \"status\": \"مكتمل\",\n \"small_description\": \"إنشاء برج تجاري ذكي بارتفاع 38 طابقاً.\",\n \"cover_image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/projects\\/project-1.jpg\"\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"per_page\": 6,\n \"current_page\": 1,\n \"last_page\": 1\n },\n \"seo\": {\n \"meta_title\": \"المشاريع الهندسية والإنشائية\"\n }\n },\n \"errors\": null\n}" } ] }, { "name": "GET Project Details by Slug", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/projects/:slug", "host": [ "{{base_url}}" ], "path": [ "api", "projects", ":slug" ], "variable": [ { "key": "slug", "value": "riyadh-financial-business-tower", "description": "Project slug (e.g. `riyadh-financial-business-tower` or `mashrou-1`)" } ] }, "description": "Returns complete details for a specific project including location, status, completion year, gallery images, industry info, and related projects." }, "response": [ { "name": "200 OK - Project Details", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"title\": \"برج الأعمال والمال المركزي بالرياض\",\n \"slug\": \"riyadh-financial-business-tower\",\n \"other_slug\": \"riyadh-financial-business-tower\",\n \"location\": \"طريق الملك فهد، الرياض\",\n \"completion_year\": \"2025\",\n \"status\": \"مكتمل\",\n \"small_description\": \"إنشاء برج تجاري ذكي بارتفاع 38 طابقاً.\",\n \"full_description\": \"يمثل برج الأعمال والمال بالرياض علامة معمارية بارزة...\",\n \"cover_image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/projects\\/project-1.jpg\",\n \"industry\": {\n \"id\": 1,\n \"title\": \"القطاع التجاري\",\n \"slug\": \"commercial\"\n },\n \"project_images\": [\n \"http:\\/\\/127.0.0.1:8000\\/storage\\/projects\\/gallery\\/p-1-1.jpg\",\n \"http:\\/\\/127.0.0.1:8000\\/storage\\/projects\\/gallery\\/p-1-2.jpg\"\n ],\n \"related_projects\": [],\n \"seo\": {\n \"meta_title\": \"برج الأعمال والمال المركزي بالرياض\"\n }\n },\n \"errors\": null\n}" }, { "name": "404 Not Found - Project Invalid Slug", "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"message\": \"Resource not found\",\n \"data\": null,\n \"errors\": null\n}" } ] }, { "name": "GET Project Types (Industries Dropdown)", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/projects-types", "host": [ "{{base_url}}" ], "path": [ "api", "projects-types" ] }, "description": "Returns list of active industry categories (ID, title, slug) for project filter tabs." }, "response": [ { "name": "200 OK - Project Types List", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"id\": 1,\n \"title\": \"القطاع التجاري\",\n \"slug\": \"commercial\"\n },\n {\n \"id\": 2,\n \"title\": \"القطاع السكني\",\n \"slug\": \"residential\"\n }\n ],\n \"errors\": null\n}" } ] } ] }, { "name": "04 - Industries", "description": "Endpoints for Industries index and Industry details with related challenges, solutions, and projects.", "item": [ { "name": "GET Industries Index", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/industries", "host": [ "{{base_url}}" ], "path": [ "api", "industries" ] }, "description": "Returns list of all active industries with images, titles, descriptions, page banner, \"Why Choose Us\" block, and SEO." }, "response": [ { "name": "200 OK - Industries List", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"banner\": {\n \"title\": \"القطاعات والصناعات\",\n \"image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/banners\\/industries.jpg\"\n },\n \"industries\": [\n {\n \"id\": 1,\n \"title\": \"القطاع التجاري\",\n \"slug\": \"commercial\",\n \"other_slug\": \"commercial\",\n \"description\": \"المباني التجارية والمراكز والمجمعات المكتبية.\",\n \"image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/industries\\/commercial.jpg\"\n }\n ],\n \"why_choose_us\": null,\n \"seo\": {\n \"meta_title\": \"القطاعات والصناعات\"\n }\n },\n \"errors\": null\n}" } ] }, { "name": "GET Industry Details by Slug", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/industries/:slug", "host": [ "{{base_url}}" ], "path": [ "api", "industries", ":slug" ], "variable": [ { "key": "slug", "value": "commercial", "description": "Industry slug (e.g. `commercial`, `residential`, `industrial`)" } ] }, "description": "Returns details for a specific industry including industry challenges, gallery images, related solutions, and related projects." }, "response": [ { "name": "200 OK - Industry Details", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"title\": \"القطاع التجاري\",\n \"slug\": \"commercial\",\n \"other_slug\": \"commercial\",\n \"image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/industries\\/commercial.jpg\",\n \"description\": \"المباني التجارية والمراكز والمجمعات المكتبية.\",\n \"related_solutions\": [],\n \"related_projects\": [],\n \"industry_challenges\": [],\n \"industry_images\": [],\n \"seo\": {\n \"meta_title\": \"القطاع التجاري\"\n }\n },\n \"errors\": null\n}" } ] } ] }, { "name": "05 - Articles & Blogs", "description": "Endpoints for fetching engineering articles, news, and blog posts.", "item": [ { "name": "GET Blogs Index", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/blogs?page=1&homepage=0", "host": [ "{{base_url}}" ], "path": [ "api", "blogs" ], "query": [ { "key": "page", "value": "1", "description": "Page number for paginated list (9 articles per page)" }, { "key": "homepage", "value": "0", "description": "Set to 1 to limit results to 9 latest items without pagination meta" } ] }, "description": "Returns paginated list of published articles in the requested language (`Accept-Language: ar` or `en`)." }, "response": [ { "name": "200 OK - Blogs List", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"banner\": null,\n \"blogs\": [\n {\n \"id\": 1,\n \"title\": \"البناء المستدام: كيف تعيد رؤية المملكة 2030 صياغة مفهوم المباني الخضراء\",\n \"slug\": \"مقال-1\",\n \"excerpt\": \"تعرف على الدور المحوري لمعايير البناء الأخضر...\",\n \"cover_image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/blogs\\/blog-1.jpg\",\n \"published_at\": \"03 August 2026\",\n \"reading_time\": 2,\n \"author\": \"م. أحمد المنصور\"\n }\n ],\n \"pagination\": {\n \"total\": 8,\n \"per_page\": 9,\n \"current_page\": 1,\n \"last_page\": 1\n },\n \"seo\": {\n \"meta_title\": \"المقالات والأخبار\"\n }\n },\n \"errors\": null\n}" } ] }, { "name": "GET Blog Details by Slug", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/blogs/:slug", "host": [ "{{base_url}}" ], "path": [ "api", "blogs", ":slug" ], "variable": [ { "key": "slug", "value": "مقال-1", "description": "Blog translation slug (e.g. `مقال-1` or `sustainable-construction-how-ksa-vision-2030-is-shaping-green-buildings`)" } ] }, "description": "Fetches complete article content, author name, published date, last updated date, related articles, and SEO metadata." }, "response": [ { "name": "200 OK - Blog Details", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"title\": \"البناء المستدام: كيف تعيد رؤية المملكة 2030 صياغة مفهوم المباني الخضراء\",\n \"slug\": \"مقال-1\",\n \"cover_image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/blogs\\/blog-1.jpg\",\n \"content\": \"

يشهد قطاع التشييد والبناء في المملكة العربية السعودية تحولاً جذرياً ونوعياً...<\\/p>\",\n \"Published Date\": \"03 أغسطس 2026\",\n \"last update\": \"03 أغسطس 2026\",\n \"Author\": \"م. أحمد المنصور\",\n \"related_articles\": [],\n \"seo\": {\n \"meta_title\": \"البناء المستدام: كيف تعيد رؤية المملكة 2030 صياغة مفهوم المباني الخضراء\"\n }\n },\n \"errors\": null\n}" } ] } ] }, { "name": "06 - Clients & Partners", "description": "Endpoints for Client & Partner logos, success stories, and trust highlights.", "item": [ { "name": "GET Clients & Partners Page Data", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/clients-partner", "host": [ "{{base_url}}" ], "path": [ "api", "clients-partner" ] }, "description": "Fetches client logos list, strategic partners list, \"Why Choose Us\" block, page banner, and SEO." }, "response": [ { "name": "200 OK - Clients & Partners Data", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"banner\": null,\n \"clients\": [],\n \"partners\": [],\n \"why_choose_us\": null,\n \"seo\": {\n \"meta_title\": \"العملاء والشركاء\"\n }\n },\n \"errors\": null\n}" } ] } ] }, { "name": "07 - Contact & Quote", "description": "Endpoints for Contact Us page, submitting inquiries & quote requests, and Request Quote page data.", "item": [ { "name": "GET Contact Page Data", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/contact", "host": [ "{{base_url}}" ], "path": [ "api", "contact" ] }, "description": "Fetches contact page banner, list of company branches with maps and phone numbers, and SEO metadata." }, "response": [ { "name": "200 OK - Contact Page Data", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"banner\": null,\n \"branches\": [\n {\n \"id\": 1,\n \"name\": \"الفرع الرئيسي - الرياض\",\n \"address\": \"طريق الملك فهد، العليا، الرياض\",\n \"phone\": \"+966 11 234 5678\",\n \"map_link\": \"https:\\/\\/maps.google.com\\/?q=24.7136,46.6753\"\n }\n ],\n \"seo\": {\n \"meta_title\": \"تواصل معنا\"\n }\n },\n \"errors\": null\n}" } ] }, { "name": "POST Submit Contact Form", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 201\", function () {", " pm.response.to.have.status(201);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"full_name\": \"Eng. Abdullah Al-Harbi\",\n \"email\": \"abdullah@example.com\",\n \"phone\": \"+966501234567\",\n \"solution_type\": \"HVAC Systems\",\n \"message\": \"We would like to request a technical proposal for our commercial tower project in Riyadh.\"\n}" }, "url": { "raw": "{{base_url}}/api/contact", "host": [ "{{base_url}}" ], "path": [ "api", "contact" ] }, "description": "Submits a new inquiry or quotation request. Rate limited to 6 requests per minute (`throttle:6,1`).\n\n### Validation Rules:\n- `full_name`: Required | string | max:255\n- `email`: Required | email | max:255\n- `phone`: Required | string | max:50\n- `solution_type`: Required without `page_slug` | nullable | string | max:255\n- `message`: Required without `page_slug` | nullable | string\n- `page_slug`: Required without `solution_type` | nullable | string | max:255" }, "response": [ { "name": "201 Created - Submission Successful", "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Your message has been sent successfully.\",\n \"data\": null,\n \"errors\": null\n}" }, { "name": "422 Unprocessable Entity - Validation Error", "status": "Unprocessable Content", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": false,\n \"message\": \"Validation errors\",\n \"data\": null,\n \"errors\": {\n \"full_name\": [\n \"The full_name field is required.\"\n ],\n \"email\": [\n \"The email field is required.\"\n ],\n \"phone\": [\n \"The phone field is required.\"\n ]\n }\n}" }, { "name": "429 Too Many Requests - Throttle Limit Exceeded", "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Retry-After", "value": "60" } ], "body": "{\n \"message\": \"Too Many Attempts.\"\n}" } ] }, { "name": "GET Request Quote Page Data", "event": [ { "listen": "test", "script": { "exec": [ "pm.test(\"Status code is 200\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response structure is valid JSON\", function () {", " var jsonData = pm.response.json();", " pm.expect(jsonData).to.be.an('object');", " pm.expect(jsonData).to.have.property('success');", "});" ], "type": "text/javascript" } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json", "type": "text" }, { "key": "Accept-Language", "value": "{{locale}}", "type": "text", "description": "Language code (ar or en)" } ], "url": { "raw": "{{base_url}}/api/request-quote", "host": [ "{{base_url}}" ], "path": [ "api", "request-quote" ] }, "description": "Fetches request quote page banner, highlighted solution cards, and SEO metadata." }, "response": [ { "name": "200 OK - Request Quote Page Data", "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"banner\": {\n \"title\": \"طلب سعر خيارات وتفاصيل الحزمة\",\n \"image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/banners\\/quote.jpg\"\n },\n \"solutions\": [\n {\n \"title\": \"مقاولات الأعمال الكهروميكانيكية (MEP)\",\n \"description\": \"تقديم كافة أعمال الهندسة والتوريد.\",\n \"image\": \"http:\\/\\/127.0.0.1:8000\\/storage\\/solutions\\/solution-1.jpg\",\n \"slug\": \"halul-mep\"\n }\n ],\n \"seo\": {\n \"meta_title\": \"طلب عرض سعر\"\n }\n },\n \"errors\": null\n}" } ] } ] } ] }