Titelwelt.
API
API v1

Marken-Asset-API

Logos, Icons, Bilder und Texte unserer Marken direkt einbinden. Eine Regel genügt: /v1/{marke}/{schlüssel} — für eine andere Marke tauschen Sie genau ein Wort.

Sofort loslegen

  1. API-Schlüssel beim Marken-Team anfordern (Administratoren: unter „API-Zugänge").
  2. Schlüssel bei jedem Aufruf mitsenden — als Header Authorization: Bearer … oder für Bild-URLs als ?api_key=….
  3. Marke und Schlüssel in den Pfad setzen — fertig.

Verfügbare Marken (Slugs)

Klicken Sie eine Marke an — alle Beispiele und die Konsole auf dieser Seite nutzen sie sofort.

Marken werden geladen…

Ihr erster Aufruf

curl "https://brand.co-red.de/api/public/v1/waz/logo-farbig" \
  -H "Authorization: Bearer bp_live_xxxxxxxxxxxxxxxx"

Antwort (gekürzt)

{
  "data": {
    "key": "logo-farbig",
    "brand": "waz",
    "files": { "svg": { "url": "https://…/logo.svg?v=8f2a1c9e" } }
  }
}

Eine Adresse für alle Marken

const logo = (brand) =>
  `https://brand.co-red.de/api/public/v1/${brand}/logo-farbig.svg?api_key=${KEY}`;

<img src={logo("waz")} alt="WAZ" />
<img src={logo("nrz")} alt="NRZ" />

Direkt ausprobieren

Schlüssel eintragen, Endpunkt wählen, senden. Der Schlüssel bleibt nur in diesem Browser-Tab und wird nirgends gespeichert.

GET /api/public/v1/waz/logo-farbig

Alle verfügbaren Schlüssel

Die Schlüssel sind bei allen Marken gleich — hier steht jeder Schlüssel deshalb nur einmal. Für eine andere Marke tauschen Sie nur den Marken-Teil im Pfad. Klicken zum Kopieren.

Referenz

Basis-URL: https://brand.co-red.de/api/public/v1 — alle Endpunkte sind reine Lesezugriffe (GET). Details bei Bedarf aufklappen.

Empfohlener Abruf

Marken-Assets ändern sich selten — oft nur wenige Male im Jahr. Rufen Sie die API daher nicht bei jedem Seitenaufruf Ihrer Anwendung auf, sondern speichern Sie die Dateien lokal (Server, CDN oder Build-Prozess) und synchronisieren Sie regelmäßig:

  1. Einmalig vollständig laden: Rufen Sie /manifest ab und laden Sie alle benötigten Dateien herunter. Die Datei-URLs enthalten ?v=… und sind versioniert — sie können dauerhaft zwischengespeichert werden.
  2. Täglich auf Änderungen prüfen: Einmal pro Tag genügt vollkommen. Nutzen Sie /manifest?since={Zeitpunkt der letzten Synchronisation} — Sie erhalten nur die Assets zurück, die sich seitdem geändert haben. Laden Sie genau diese Dateien neu; alles andere bleibt unangetastet.
  3. Alternativ per ETag: Speichern Sie den ETag jeder Antwort und senden Sie ihn beim nächsten Mal als If-None-Match mit. Bei unveränderten Daten antwortet die API mit einem schlanken 304 ohne Inhalt.

Faustregel

Dateien, die sich einmal im Jahr ändern, brauchen keine 600 Abrufe pro Minute: 1× vollständig laden, 1× täglich synchronisieren, dazwischen nur lokale Kopien ausliefern. So bleibt Ihre Anwendung schnell, funktioniert auch bei einem API-Ausfall weiter und schont das Kontingent Ihres Schlüssels.

Gut zu wissen

Erfolgreiche Antworten liefern immer ein Objekt mit data. Fehler folgen einem einheitlichen Schema und enthalten einen Hinweis mit den ähnlichsten gültigen Schlüsseln:

Fehlerformat

{
  "error": {
    "code": "not_found",
    "message": "No asset registered for key 'logo-gruen' on brand 'waz'.",
    "hint": "Meinten Sie: logo-farbig, logo-schwarz?"
  }
}
StatusBedeutung
200Erfolg — Antwort enthält data
302Weiterleitung auf die Datei (Pfad mit Endung)
304Unverändert — Ihr Cache ist aktuell (ETag)
401API-Schlüssel fehlt oder ist ungültig
404Marke, Schlüssel oder Format unbekannt
429Rate-Limit erreicht — kurz warten und erneut versuchen
  • ETag / 304: Jede JSON-Antwort enthält einen ETag. Senden Sie ihn als If-None-Match mit, erhalten Sie bei unveränderten Daten ein schlankes 304.
  • Datei-URLs sind versioniert: Der Parameter ?v=… ändert sich bei jedem Austausch. Dateien dürfen daher dauerhaft (immutable) zwischengespeichert werden.
  • Fallback: Mit ?fallback=1 liefert die API eine verfügbare Variante statt eines Fehlers und kennzeichnet dies im Feld fallback_from.
  • Rate-Limit: Standardmäßig 600 Anfragen pro Minute und Schlüssel. Bei Überschreitung antwortet die API mit 429.
  • Nur lesen: Schreiboperationen sind nicht vorgesehen.

Fragen oder Wünsche zur API? Wenden Sie sich an das Marken-Team.