openapi: 3.0.3
info:
  title: SES.Hospedajes API
  version: 1.0.2
  description: API para clientes Premium de SES.Hospedajes con API Key en X-Api-Key.
servers:
  - url: https://tudominio.com/api/v1
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
security:
  - ApiKeyAuth: []
paths:
  /establishments:
    get:
      summary: Listar establecimientos
      responses:
        '200': { description: OK }
  /guests:
    get:
      summary: Listar huéspedes
      responses:
        '200': { description: OK }
    post:
      summary: Crear huésped
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [ nombre, apellidos, documento, establecimiento_id ]
              properties:
                nombre: { type: string }
                apellidos: { type: string }
                documento: { type: string }
                establecimiento_id: { type: integer }
      responses:
        '201': { description: Creado }
  /rentals:
    get:
      summary: Listar contratos
      responses:
        '200': { description: OK }
    post:
      summary: Crear contrato
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [ referencia, fecha_entrada, fecha_salida, establecimiento_id ]
              properties:
                referencia: { type: string }
                fecha_entrada: { type: string, format: date-time }
                fecha_salida: { type: string, format: date-time }
                establecimiento_id: { type: integer }
      responses:
        '201': { description: Creado }
  /precheckins:
    post:
      summary: Generar link de precheckin
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [ establecimiento_id ]
              properties:
                establecimiento_id: { type: integer }
      responses:
        '201': { description: Creado }