API und Agent-Zugriff

Konventionen

• Hänge .md an jede Content-URL an, um sauberes Markdown mit Frontmatter (Titel, Beschreibung, Sprache, kanonische URL, Daten) zu erhalten. Beispiel: /de/kurse/foundations.md
• Die read-only JSON-API liegt unter /api/v1. Deutsche Inhalte werden unter /api/v1/de ausgeliefert.
• Entdecke alles Maschinenlesbare über /de/llms.txt (Deutsch) oder /llms.txt (Englisch); /de/llms-full.txt ist der volle Korpus in einem Dokument.
• Jede JSON-Antwort trägt ein stabiles Schema, ein Sprachfeld und kanonische Website-URLs.

Endpunkte

• GET /api/v1/de/index.json - API-Discovery-Dokument mit allen Endpunkten
• GET /api/v1/openapi.json - OpenAPI-3.1-Spezifikation der gesamten API
• GET /api/v1/de/courses.json - Alle Kurse inklusive Lektionen
• GET /api/v1/de/courses/{slug}.json - Ein einzelner Kurs mit voller Lektionsliste
• GET /api/v1/de/lessons.json - Alle Lektionen als Metadaten
• GET /api/v1/de/lessons/{slug}.json - Volle Details einer einzelnen Lektion
• GET /api/v1/de/fundamentals.json - Alle Grundlagen-Seiten für Einsteiger
• GET /api/v1/de/articles.json - Alle Wissens-Artikel
• GET /api/v1/de/builds.json - Alle Projekt-Case-Studies des Gründers
• GET /api/v1/de/resources.json - Alle Ressourcen mit vollem Inhalt
• GET /api/v1/de/changelog.json - Alle Changelog-Einträge mit Tool-News
• GET /api/v1/de/search-index.json - Flacher Suchindex für Client- oder Agent-Suche

Beispiele

curl https://agenticschool.dev/api/v1/de/courses.json
curl https://agenticschool.dev/api/v1/de/lessons/your-first-project-scaffolding-dev-server-git-and-github.json
curl https://agenticschool.dev/de/kurse/foundations.md
curl https://agenticschool.dev/de/llms.txt

Markdown für jede Seite

Jeder Kurs, jede Lektion, jeder Wissens-Artikel, jede Grundlage, jedes Projekt, jede Ressource und jeder Changelog-Eintrag hat einen Markdown-Zwilling unter seiner menschlichen URL plus .md-Endung, in beiden Sprachen. Content-Seiten weisen ihn zusätzlich mit einem <link rel="alternate" type="text/markdown"> Tag aus.

Faire Nutzung

Diese Oberfläche ist vollständig statisch und wird über ein CDN ausgeliefert, daher gibt es keine harten Rate-Limits. Bitte cache Antworten, bevorzuge die JSON- und .md-Endpunkte gegenüber HTML-Scraping, identifiziere deinen Agent mit einem aussagekräftigen User-Agent und nutze /de/llms-full.txt für den vollen Korpus auf einen Schlag, statt jede Seite zu crawlen. Eine Richtgrösse von rund 60 Anfragen pro Minute hält die Oberfläche für alle gesund.

Schnellzugriff

• llms.txt
• llms-full.txt
• OpenAPI 3.1
• API-Discovery-Dokument mit allen Endpunkten