API Overview¶

Authorization: Bearer your_api_token

X-Odoo-Signature: sha256=signature_here

{
  "success": true,
  "data": {
    // Endpoint-specific data
  },
  "metadata": {
    "api_version": "1.0",
    "timestamp": "2026-02-26T11:30:00Z",
    "request_id": "abc123def456"
  }
}

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Error description",
    "details": {
      // Additional details
    }
  },
  "metadata": {
    "api_version": "1.0",
    "timestamp": "2026-02-26T11:30:00Z",
    "request_id": "abc123def456"
  }
}

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1617032400

async function callAirDooAPI(endpoint, data) {
  try {
    const response = await fetch(endpoint, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify(data)
    });

    const result = await response.json();

    if (!result.success) {
      switch (result.error.code) {
        case 'UNAUTHORIZED':
          // Re-authenticate
          break;
        case 'CONFLICT':
          // Show message to user
          break;
        default:
          // Generic error
      }
    }

    return result;
  } catch (error) {
    console.error('Network error:', error);
    throw error;
  }
}

const CACHE_DURATION = 5 * 60 * 1000; // 5 minutes

const calendarCache = new Map();

async function getCachedCalendar(accommodationId, month, year) {
  const cacheKey = `${accommodationId}-${month}-${year}`;
  const cached = calendarCache.get(cacheKey);

  if (cached && Date.now() - cached.timestamp < CACHE_DURATION) {
    return cached.data;
  }

  const data = await getCalendarData(accommodationId, month, year);
  calendarCache.set(cacheKey, {
    data,
    timestamp: Date.now()
  });

  return data;
}

async function callWithRetry(endpoint, data, maxRetries = 3) {
  let lastError;

  for (let i = 0; i < maxRetries; i++) {
    try {
      return await callAirDooAPI(endpoint, data);
    } catch (error) {
      lastError = error;
      const delay = Math.pow(2, i) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
    }
  }

  throw lastError;
}

def validate_booking_request(data):
    if data['checkin'] >= data['checkout']:
        raise ValidationError("Check-in must be before check-out")

    if data['guest_count'] <= 0:
        raise ValidationError("Guest count must be positive")

    if data['total_amount'] <= 0:
        raise ValidationError("Total amount must be positive")

import axios from 'axios';

const airDooAPI = axios.create({
  baseURL: 'https://your-odoo.com',
  headers: {
    'Authorization': 'Bearer your_api_token'
  }
});