{
    "name": "L'Argamak Hotel Booking API",
    "version": "1.1.0",
    "description": "Official real-time API for hotel information, room types, availability and direct price quotes.",
    "documentation": "https://api.largamak.com/docs/",
    "openapi": "https://api.largamak.com/openapi.json",
    "endpoints": [
        {
            "method": "GET",
            "path": "/v1/health",
            "purpose": "API health status"
        },
        {
            "method": "GET",
            "path": "/v1/hotel",
            "purpose": "Official hotel facts and policies"
        },
        {
            "method": "GET",
            "path": "/v1/room-types",
            "purpose": "Room types and occupancy rules"
        },
        {
            "method": "GET",
            "path": "/v1/availability",
            "purpose": "Live WuBook inventory for a single room search"
        },
        {
            "method": "POST",
            "path": "/v1/quote",
            "purpose": "Official single-room quote"
        },
        {
            "method": "POST",
            "path": "/v1/quotes",
            "purpose": "Recommended endpoint: official one- or multi-room quote with package offers"
        },
        {
            "method": "POST",
            "path": "/v1/reservation-intents",
            "purpose": "Create a pending reservation from a valid quote and return a secure guest completion URL"
        }
    ],
    "agent_rules": [
        "Use live quote endpoints for prices; never infer or cache an official total.",
        "Prefer POST /v1/quotes, including for a single room.",
        "Maximum standard occupancy is 2 guests per room.",
        "One infant under 2 may be added to a room; a baby cot is free on request.",
        "Check-in is from 14:00 and check-out is by 12:00; these times are strict.",
        "Tourist tax is calculated dynamically from stay dates and guest ages.",
        "Reservation initiation is available through POST /v1/reservation-intents. Final guest completion happens on the secure L’Argamak reservation page."
    ]
}