maps-saas/apps/web/public/uruk-postman-collection.json

{
  "info": {
    "name": "Siro Maps - Sovereign Heritage & Community Guides API",
    "description": "Production Endpoints for National Heritage Landmarks, Precision Gate Navigation, and Moderated Local Guides Gamification.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://map-saas.intaleqapp.com/api",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "zP9vL5mK2nQ8xR7jT4wS1yB6hG3fV0cX",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "1. Heritage - List All Landmarks",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{apiKey}}" }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/heritage/landmarks",
          "host": ["{{baseUrl}}"],
          "path": ["v1", "heritage", "landmarks"]
        }
      }
    },
    {
      "name": "2. Heritage - Nearby Landmarks (Spatial Query)",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{apiKey}}" }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/heritage/landmarks?lat=31.9539&lng=35.9350&radius=10000",
          "host": ["{{baseUrl}}"],
          "path": ["v1", "heritage", "landmarks"],
          "query": [
            { "key": "lat", "value": "31.9539" },
            { "key": "lng", "value": "35.9350" },
            { "key": "radius", "value": "10000" }
          ]
        }
      }
    },
    {
      "name": "3. Heritage - Single Landmark by Slug",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{apiKey}}" }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/heritage/landmarks/amman-citadel",
          "host": ["{{baseUrl}}"],
          "path": ["v1", "heritage", "landmarks", "amman-citadel"]
        }
      }
    },
    {
      "name": "4. Heritage - Offline Pack for Mobile",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{apiKey}}" }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/heritage/offline-pack",
          "host": ["{{baseUrl}}"],
          "path": ["v1", "heritage", "offline-pack"]
        }
      }
    },
    {
      "name": "5. Community - List Badges",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{apiKey}}" }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/community/badges",
          "host": ["{{baseUrl}}"],
          "path": ["v1", "community", "badges"]
        }
      }
    },
    {
      "name": "6. Community - Submit Contribution (Suggest Gate)",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Content-Type", "value": "application/json" },
          { "key": "x-api-key", "value": "{{apiKey}}" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"userId\": \"guide_hamza_001\",\n  \"displayName\": \"حمزة عايد\",\n  \"contributionType\": \"CONFIRM_GATE\",\n  \"targetTable\": \"heritage.landmarks\",\n  \"targetId\": 3,\n  \"placeName\": \"مدينة جرش - البوابة الجنوبية السياحية\",\n  \"lat\": 32.2731,\n  \"lng\": 35.8924,\n  \"suggestedData\": { \"gate_name\": \"South Main Gate\" },\n  \"notes\": \"تم تأكيد موقع بوابة التذاكر الميدانية\"\n}"
        },
        "url": {
          "raw": "{{baseUrl}}/v1/community/contribute",
          "host": ["{{baseUrl}}"],
          "path": ["v1", "community", "contribute"]
        }
      }
    },
    {
      "name": "7. Community - Guide Profile & Points",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{apiKey}}" }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/community/profile/guide_hamza_001",
          "host": ["{{baseUrl}}"],
          "path": ["v1", "community", "profile", "guide_hamza_001"]
        }
      }
    },
    {
      "name": "8. Community - Leaderboard",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{apiKey}}" }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/community/leaderboard",
          "host": ["{{baseUrl}}"],
          "path": ["v1", "community", "leaderboard"]
        }
      }
    },
    {
      "name": "9. Admin - Moderation Pending Queue",
      "request": {
        "method": "GET",
        "header": [
          { "key": "x-api-key", "value": "{{apiKey}}" }
        ],
        "url": {
          "raw": "{{baseUrl}}/v1/admin/moderation/pending",
          "host": ["{{baseUrl}}"],
          "path": ["v1", "admin", "moderation", "pending"]
        }
      }
    },
    {
      "name": "10. Admin - Review Contribution (Approve)",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Content-Type", "value": "application/json" },
          { "key": "x-api-key", "value": "{{apiKey}}" }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"contributionId\": 1,\n  \"action\": \"APPROVE\",\n  \"reviewerName\": \"Hamza Ayed (Admin)\",\n  \"reviewerNotes\": \"معتمدة ومطابقة لصور الأقمار الصناعية\"\n}"
        },
        "url": {
          "raw": "{{baseUrl}}/v1/admin/moderation/review",
          "host": ["{{baseUrl}}"],
          "path": ["v1", "admin", "moderation", "review"]
        }
      }
    }
  ]
}