Integration API Developer Guide

// Create a new property with hierarchical location
const propertyData = {
  data: {
    Title: "Luxury Villa",
    Type: "villa",
    Price: 750000,
    Bedroom: 5,
    Bathrooms: 4,
    "Square Meters": 250,
    Description: "A beautiful luxury villa with amazing views",
    
    // Hierarchical Location - NEW: Use structured location data
    Region: {
      id: 104,
      name: "Τήνος",
      nameEN: "Tinos"
    },
    SubRegion: {
      id: 2402,
      name: "Υστέρνια",
      nameEN: "Ysternia"
    },
    Area: {
      id: 123304,
      name: "Δέση",
      nameEN: "Desi"
    },
    
    // Alternative: Simple ID format (names auto-resolved)
    // Region: 104,
    // SubRegion: 2402,
    // Area: 123304,
    
    // Geographic coordinates
    Location: {
      lat: 37.9838,
      lng: 23.7275
    },
    isPublic: true
  }
};

const response = await fetch('https://prop360.pro/api/integration/properties', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(propertyData)
});

const result = await response.json();
console.log('Property created:', result);

// Upload images to a property
const formData = new FormData();
formData.append('images', file1);
formData.append('images', file2);

const response = await fetch(
  'https://prop360.pro/api/integration/properties/PROPERTY_ID/images',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_TOKEN'
    },
    body: formData
  }
);

const result = await response.json();
console.log('Images uploaded:', result);

// Supported formats: JPEG, JPG, PNG, WebP
// Max file size: 10MB per image

// List, get, update, and delete properties
const BASE_URL = 'https://prop360.pro/api/integration/';
const headers = {
  'Authorization': 'Bearer YOUR_API_TOKEN',
  'Content-Type': 'application/json'
};

// List properties (paginated)
const listRes = await fetch(`${BASE_URL}properties?page=1&limit=10`, { headers });
const { properties, pagination } = await listRes.json();
console.log(`Found ${pagination.total} properties`);

// Get a single property by MongoDB id
const propertyId = properties[0].id;
const getRes = await fetch(`${BASE_URL}properties/${propertyId}`, { headers });
const { property } = await getRes.json();

// Update a property (send only fields you want to change)
const updateRes = await fetch(`${BASE_URL}properties/${propertyId}`, {
  method: 'PUT',
  headers,
  body: JSON.stringify({
    data: {
      Title: 'Updated Apartment Title',
      Price: 360000,
      isPublic: true
    }
  })
});
const updated = await updateRes.json();

// Delete a property (soft delete — requires delete permission on token)
const deleteRes = await fetch(`${BASE_URL}properties/${propertyId}`, {
  method: 'DELETE',
  headers
});
const deleted = await deleteRes.json();
console.log(deleted.message);

// Common error responses
const response = await fetch('https://prop360.pro/api/integration/properties', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

if (!response.ok) {
  const { error } = await response.json();
  switch (response.status) {
    case 401:
      // { error: "Invalid or inactive token" }
      // { error: "No valid authorization header" }
      break;
    case 403:
      // { error: "Token does not have delete permission" }
      break;
    case 404:
      // { error: "Property not found" }
      break;
    case 400:
      // { error: "Invalid location data: ..." }
      break;
    default:
      console.error(error);
  }
}