API e accesso agente

Convenzioni

• Aggiungi .md a qualsiasi URL di contenuto per ottenere un Markdown pulito con il frontmatter (titolo, descrizione, impostazioni internazionali, canonico, date). Esempio: /corsi/fondazioni.md
• Il file di sola lettura JSON API si trova in /api/v1. Il contenuto tedesco viene servito in /api/v1/de.
• Scopri tutto ciò che è leggibile dalla macchina da /llms.txt (inglese) o /de/llms.txt (tedesco); /llms-full.txt è il corpus completo in un unico documento.
• Ogni payload JSON contiene uno schema stabile, un campo locale e URL canonici del sito.

Endpoint

• GET /api/v1/it/index.json - API documento di rilevamento con ogni endpoint
• GET /api/v1/openapi.json - OpenAPI Specifiche 3.1 per l'intero API
• GET /api/v1/it/courses.json - Elenca tutti i corsi con le relative lezioni
• GET /api/v1/it/courses/{slug}.json - Un corso unico con elenco completo delle lezioni
• GET /api/v1/it/lessons.json - Tutte le lezioni come metadati
• GET /api/v1/it/lessons/{slug}.json - Dettagli completi per una singola lezione
• GET /api/v1/it/fundamentals.json - Tutte le pagine di riferimento per principianti
• GET /api/v1/it/articles.json - Tutti gli articoli della conoscenza
• GET /api/v1/it/builds.json - Tutti i casi di studio del progetto del fondatore
• GET /api/v1/it/resources.json - Tutte le risorse con contenuto completo
• GET /api/v1/it/changelog.json - Tutte le voci del registro delle modifiche alle novità sugli strumenti
• GET /api/v1/it/search-index.json - Indice di ricerca piatto per la ricerca di clienti o agenti

Esempi

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

Markdown per qualsiasi pagina

Ogni corso, lezione, articolo informativo, nozione fondamentale, build, risorsa e voce del log delle modifiche ha un gemello Markdown nel suo URL umano più un suffisso .md, in entrambe le versioni locali. Le pagine di contenuto lo pubblicizzano anche con un tag <link rel="alternate" type="text/markdown">.

Utilizzo corretto

Questa superficie è completamente statica e servita da una CDN, quindi non ci sono limiti di velocità rigidi. Memorizza nella cache le risposte, preferisci gli endpoint JSON e .md rispetto allo scraping HTML, identifica il tuo agente con uno User-Agent descrittivo e utilizza /llms-full.txt per un corpus completo one-shot invece di eseguire la scansione di ogni pagina. Un tetto di cortesia di circa 60 richieste al minuto mantiene la superficie sana per tutti.

Collegamenti rapidi

• llms.txt
• llms-full.txt
• OpenAPI 3.1
• API documento di rilevamento con ogni endpoint