Inhalte per API abrufen

Wenn du deine Inhalte in eine eigene Website oder App einbaust, holst du sie über die REST-Auslieferungs-API ab. Basis-URL: https://app.nevocms.com.

Authentifizierung

Jede Anfrage trägt den API-Schlüssel deines Workspace im Authorization-Header:

Authorization: Bearer <API-Schlüssel deines Workspace>

Endpunkte

GET /api/rest/<collection> – Liste der Dokumente einer Collection
GET /api/rest/<collection>/<id> – ein einzelnes Dokument

Parameter der Liste

Parameter	Bedeutung
`locale`	nur Dokumente dieser Sprache
`status`	Standard: `published`
`slug`	nach Slug filtern
`search`	Volltextsuche über den Titel
`sort` / `sortDir`	Sortierfeld und Richtung (`asc` oder `desc`)
`page`	Seite der Ergebnisse
`limit`	Einträge pro Seite, 1–500, Standard 25

Antwortformat

Die Liste antwortet mit { docs, total, page, totalPages }. Jedes Dokument enthält id, slug, title, status, locale, data, publishedAt, updatedAt und translations. Rich-Text-Felder liefert die API als Markdown, Bildfelder als Objekt mit url, path, alt, width, height und variants.

Beispiel mit curl

curl "https://app.nevocms.com/api/rest/posts?locale=de&status=published&limit=10" \
  -H "Authorization: Bearer <API-Schlüssel>"

Beispiel mit fetch

const res = await fetch(
  "https://app.nevocms.com/api/rest/posts?locale=de&status=published&limit=10",
  { headers: { Authorization: `Bearer ${API_KEY}` } },
);
const { docs, total } = await res.json();