openapi: 3.1.0
info:
  title: OXM.mx Gaming News API
  description: |
    API para acceder a noticias de gaming, esports, reseñas de videojuegos y guías en México.
    
    OXM.mx es el portal líder de gaming en México, proporcionando contenido editorial independiente
    y verificado para gamers mexicanos y latinoamericanos.
    
    ## Categorías disponibles:
    - **Noticias**: Noticias diarias de la industria de videojuegos
    - **Reseñas**: Análisis imparciales de videojuegos
    - **Guías**: Tutoriales y estrategias
    - **Esports**: Cobertura de torneos y escena competitiva
    - **Hardware**: Reviews de componentes y periféricos
    - **Opinión**: Columnas editoriales
    
    ## Idioma
    Todo el contenido está en español (es-MX)
    
  version: 1.0.0
  contact:
    name: OXM.mx Editorial
    email: contacto@oxm.com.mx
    url: https://oxm.com.mx/contact
  license:
    name: All Rights Reserved
    url: https://oxm.com.mx/terms
    
servers:
  - url: https://oxm.com.mx
    description: Production server

paths:
  /:
    get:
      operationId: getHomepage
      summary: Obtener página principal
      description: Retorna las noticias destacadas y últimas publicaciones
      responses:
        '200':
          description: Página principal con artículos destacados
          
  /noticias:
    get:
      operationId: getNews
      summary: Obtener todas las noticias
      description: Lista de noticias de gaming ordenadas por fecha
      responses:
        '200':
          description: Lista de noticias
          
  /resenas:
    get:
      operationId: getReviews
      summary: Obtener reseñas de videojuegos
      description: Análisis y puntuaciones de videojuegos
      responses:
        '200':
          description: Lista de reseñas
          
  /guias:
    get:
      operationId: getGuides
      summary: Obtener guías de videojuegos
      description: Tutoriales, walkthroughs y estrategias
      responses:
        '200':
          description: Lista de guías
          
  /esports:
    get:
      operationId: getEsports
      summary: Obtener noticias de esports
      description: Cobertura de torneos y escena competitiva en México
      responses:
        '200':
          description: Lista de noticias de esports
          
  /hardware:
    get:
      operationId: getHardware
      summary: Obtener reviews de hardware
      description: Análisis de componentes y periféricos gaming
      responses:
        '200':
          description: Lista de reviews de hardware
          
  /autores:
    get:
      operationId: getAuthors
      summary: Obtener directorio de autores
      description: Lista de periodistas y expertos del equipo editorial
      responses:
        '200':
          description: Lista de autores
          
  /about:
    get:
      operationId: getAbout
      summary: Acerca de OXM.mx
      description: Información sobre el equipo y la publicación
      responses:
        '200':
          description: Página de información
          
  /editorial-policy:
    get:
      operationId: getEditorialPolicy
      summary: Política editorial
      description: Estándares editoriales y metodología de trabajo
      responses:
        '200':
          description: Página de política editorial
          
  /apuestas-esports:
    get:
      operationId: getBetting
      summary: Información sobre apuestas en esports
      description: Guías de juego responsable e información educativa (solo mayores de 18)
      responses:
        '200':
          description: Página de apuestas esports

tags:
  - name: Gaming
    description: Noticias y contenido de videojuegos
  - name: Esports
    description: Cobertura de competencias y torneos
  - name: Reviews
    description: Análisis de juegos y hardware
  - name: Guides
    description: Tutoriales y estrategias