Der Config-Endpunkt (/nitro/v1/config) liefert alle globalen Konfigurationsdaten, die für den Aufbau einer Nitro CMS Website benötigt werden. Dazu gehören Navigationselemente, die Seitenstruktur, globale Inhalte und allgemeine Metadaten.
Antwort
{
"nitro": {
"domain": "example.com",
"slug": "meine-website",
"version": 156,
"updated_at": 1708300800,
"language": "de",
"primary_language": "de"
},
"pages": ["home", "ueber-uns", "blog", "kontakt"],
"containers": {
"nav": {
"uid": "abc-123",
"identifier": "nav",
"label": "Navigation",
"items": [
{
"type": "page",
"target": "_self",
"label": "Über uns",
"href": "/ueber-uns",
"slug": "ueber-uns",
"properties": {},
"children": []
}
]
}
},
"globals": {}
}Abschnitte
nitro
Allgemeine Informationen zur Integration wie Domain, aktuelle Version, Sprache und Zeitstempel der letzten Aktualisierung. Der version-Wert kann auch über den schlankeren Version-Endpunkt abgefragt werden.
pages
Ein flaches Array aller gültigen Seiten-Slugs. Nutze diese Liste, um im Frontend Routen zu generieren oder ungültige URLs zu erkennen.
containers
Die Seitencontainer enthalten die hierarchische Navigationsstruktur. Jeder Container (z.B. nav, header, footer) enthält ein items-Array mit den Navigationseinträgen. Jeder Eintrag hat folgende Eigenschaften:
| Schlüssel | Beschreibung |
|---|---|
type | Art des Links: page, email, file, url, tel, nitropagelink, nitrodetaillink |
target | Link-Ziel, z.B. _self oder _blank |
label | Der angezeigte Navigationstext |
href | Die URL des Links |
slug | Der Seiten-Slug (bei Seitenlinks) |
properties | Definierte Seiteneigenschaften |
children | Verschachtelte Untereinträge (gleiche Struktur) |
globals
Globale Inhalte, die in der Nitro CMS Konfiguration definiert wurden. Dazu gehören:
- Statische Inhalte: Schlüssel-Wert-Paare für globale Einstellungen (z.B. Footer-Text, Copyright-Hinweis)
- Content Pool Inhalte: Gemappte Inhalte aus Content Pools, die auf jeder Seite verfügbar sein sollen (z.B. Standorte, Partner)
Caching
Da der Config-Endpunkt alle globalen Daten liefert, ist er ressourcenintensiver als andere Endpunkte. Nutze den Version-Endpunkt zur Cache-Validierung, um unnötige Config-Abrufe zu vermeiden.