openapi: 3.0.1
info:
  title: Ettaouly Digital API
  description: Public read-only resources for Ettaouly Digital articles, AI context and agent discovery.
  version: 'v1'
externalDocs:
  description: LLM-friendly public reference
  url: https://ettaoulyabdelali.com/llms.txt
servers:
  - url: https://ettaoulyabdelali.com
paths:
  /feed.json:
    get:
      operationId: getLatestArticles
      summary: Retrieves the latest blog articles and news
      responses:
        "200":
          description: OK
          content:
            application/json:
              schema:
                type: object
  /ai-context.json:
    get:
      operationId: getAiContext
      summary: Returns the public entity and service context
      responses:
        "200":
          description: Public AI context
          content:
            application/json:
              schema:
                type: object
  /api/ai/context.json:
    get:
      operationId: getApiAiContext
      summary: Returns the public API AI context
      responses:
        "200":
          description: Public AI context
          content:
            application/json:
              schema:
                type: object
  /llms.txt:
    get:
      operationId: getLlmSummary
      summary: Returns the concise public LLM reference
      responses:
        "200":
          description: Plain-text LLM reference
          content:
            text/plain:
              schema:
                type: string
  /llms-full.txt:
    get:
      operationId: getLlmFullReference
      summary: Returns the full public LLM reference
      responses:
        "200":
          description: Full plain-text reference
          content:
            text/plain:
              schema:
                type: string