{
  "openapi": "3.1.0",
  "info": {
    "title": "Hotel Alisei & Spa Booking API (Mobile)",
    "version": "1.0.0",
    "description": "API for checking room availability, apartment rates, booking accommodations, and agent authentication at Hotel Alisei & Spa, Las Terrenas, Dominican Republic.",
    "contact": {
      "name": "Hotel Alisei Concierge",
      "url": "https://m.aliseihotelspa.com/contact.html",
      "email": "info@aliseihotelspa.com"
    }
  },
  "servers": [
    {
      "url": "https://m.aliseihotelspa.com",
      "description": "Mobile Production Server"
    },
    {
      "url": "https://movil.aliseihotelspa.com",
      "description": "Mobile Development Server"
    }
  ],
  "paths": {
    "/api/v1/booking/availability": {
      "get": {
        "summary": "Check room and apartment availability",
        "description": "Returns available apartment categories (Tipo A, B, Honeymoon Suite, Studio, Villa), rates, and occupancy rules for specified dates.",
        "operationId": "getAvailability",
        "responses": {
          "200": { "description": "Available apartments with rates and terms" }
        }
      }
    },
    "/agent/register": {
      "post": {
        "summary": "Register AI Agent",
        "description": "Register an autonomous agent via ID-JAG or anonymous flow per auth.md specification.",
        "operationId": "registerAgent",
        "responses": {
          "200": { "description": "Token issued successfully" }
        }
      }
    },
    "/agent/claim": {
      "post": {
        "summary": "Initiate Claim Ceremony",
        "description": "Request user verification code to escalate scopes to booking permissions.",
        "operationId": "claimAgent",
        "responses": {
          "200": { "description": "Claim ceremony challenge initiated" }
        }
      }
    }
  }
}
