openapi: 3.0.0
info:
  title: Cattive Platform API
  description: |
    Cattive is an AI-First platform for news portals. This API provides public
    endpoints for accessing platform information, newsroom articles, and
    platform status.
  version: 1.0.0
  contact:
    name: Cattive
    email: contato@cattive.com
    url: https://cattive.com
  license:
    name: Proprietary
    url: https://cattive.com/terms

servers:
  - url: https://cattive.com
    description: Production

paths:
  /cattive-sitemap.xml:
    get:
      operationId: getSitemap
      summary: Get the Cattive sitemap
      description: Returns the XML sitemap with all public URLs, hreflang tags, priorities, and change frequencies.
      responses:
        '200':
          description: XML sitemap
          content:
            application/xml:
              schema:
                type: string

  /cattive-llms.txt:
    get:
      operationId: getLlmsTxt
      summary: Get structured information about Cattive for AI models
      description: Returns a plain text file with structured information about the Cattive platform, products, key facts, and contact details optimized for AI consumption.
      responses:
        '200':
          description: Plain text with platform information
          content:
            text/plain:
              schema:
                type: string

  /.well-known/ai-plugin.json:
    get:
      operationId: getAiPluginManifest
      summary: Get the AI plugin manifest
      description: Returns the AI plugin manifest following the OpenAI plugin specification, including platform name, description, logo, and authentication details.
      responses:
        '200':
          description: JSON manifest
          content:
            application/json:
              schema:
                type: object
                properties:
                  name_for_human:
                    type: string
                  description_for_human:
                    type: string
                  logo_url:
                    type: string

components:
  schemas:
    PlatformInfo:
      type: object
      properties:
        name:
          type: string
          example: Cattive
        description:
          type: string
          example: AI-First Platform for News Portals
        founded:
          type: string
          example: "2009"
        headquarters:
          type: string
          example: São Paulo, Brazil
        products:
          type: array
          items:
            type: string
          example:
            - Portal PRO (Smart CMS)
            - Newsletter AI
            - Legal Advertising
            - Monetization System
            - leia.la (Link Shortener)
            - Chama.lá (WhatsApp Links)
        languages:
          type: array
          items:
            type: string
          example:
            - English
            - Portuguese (Brazil)
        website:
          type: string
          example: https://cattive.com
