Entwickler

Loslegen

Alle Routen liegen unter /api/v1 und werden über einen Authorization: Bearer-Header authentifiziert. Die Antworten sind JSON in UTF-8, CORS ist für GET offen: Ein Aufruf aus dem Browser funktioniert.

Vollständige Spezifikation (OpenAPI 3.1): /api/v1/openapi.json

Einen Schlüssel bekommen

In dieser ersten Fassung gibt es keine Selbstregistrierung: Schreiben Sie uns und beschreiben Sie den geplanten Einsatz, das erwartete Volumen und die Stelle, an der die Quellenangabe erscheinen wird. Wir legen den Schlüssel von Hand an und schicken ihn Ihnen.

Der Schlüssel wird nur EIN einziges Mal übergeben: Wir bewahren davon nur einen SHA-256-Abdruck auf und können ihn Ihnen daher nicht erneut mitteilen. Geht er verloren oder wird er offengelegt, wird er widerrufen und ersetzt — ein Widerruf ist endgültig.

Schreiben Sie uns: [email protected]

Einstiegspunkte

Parameter

• lang — ISO-639-1-Code (fr, en, zh…). Der Inhalt wird übersetzt ausgeliefert, sofern die Übersetzung vorliegt, sonst auf Englisch, sonst in der Originalsprache.
• topic — Ressort-Slug (siehe /topics).
• limit — 1 bis 50 (Standard 20).
• cursor — der nextCursor der vorherigen Antwort. Opak: Interpretieren Sie ihn nicht, seine Kodierung wird sich ändern.

Beispiele

# die neuesten Storys
curl -H "Authorization: Bearer $AUBE_KEY" \
  "https://aube.news/api/v1/stories?lang=de&limit=5"

# ein Artikel, auf Englisch
curl -H "Authorization: Bearer $AUBE_KEY" \
  "https://aube.news/api/v1/stories/mon-slug?lang=en"

# nächste Seite (opaker Cursor)
curl -H "Authorization: Bearer $AUBE_KEY" \
  "https://aube.news/api/v1/stories?limit=5&cursor=$CURSOR"

{
  "stories": [ /* … */ ],
  "nextCursor": "bzE6NQ",
  "lang": "en",
  "attribution": { "name": "Aube", "url": "https://aube.news" }
}

Kontingente und Fehler

Jeder Schlüssel hat ein Tageskontingent, das um Mitternacht zurückgesetzt wird. Die Antworten tragen X-RateLimit-Limit und X-RateLimit-Remaining; darüber hinaus antwortet die API mit 429 und Retry-After (in Sekunden) — und der abgelehnte Aufruf wird nicht angerechnet.

• 400 — ungültiger Parameter (limit außerhalb der Grenzen, Cursor unlesbar…).
• 401 — Schlüssel fehlt, unbekannt oder widerrufen.
• 404 — Story unbekannt oder nicht veröffentlicht.
• 429 — Tageskontingent erreicht.
• 500 — Fehler auf unserer Seite: erneut versuchen, dann uns Bescheid geben.

Quellenangabe

Jede Antwort trägt ein attribution-Objekt. Jede öffentliche Weiterverwendung muss „Aube“ nennen und auf die Ursprungsseite verweisen (das Feld url der Story). Das ist keine Eitelkeit: Unsere Artikel verweisen ihrerseits auf ihre Primärquellen, und diese Kette von Belegen unterscheidet eine Information von einem Gerücht.

In der Praxis:

• nennen Sie „Aube“ neben dem übernommenen Inhalt, mit einem klickbaren Link auf story.url;
• nennen Sie bei den Reihen aus /metrics AUCH die mitgelieferte Primärquelle (source.name / source.url);
• veröffentlichen Sie nicht den vollständigen Text (bodyMd) eines Artikels erneut: übernehmen Sie das TL;DR oder einen Auszug und verweisen Sie auf Aube;
• behalten Sie die Kennzeichnung „gesponserter Inhalt“ (isSponsored) bei, wo sie vorhanden ist — ohne Ausnahme.

Einbettbares Widget

Die gute Nachricht des Tages, 180 Pixel hoch, ohne Cookies und ohne Skripte Dritter. Fügen Sie dieses iframe ein, wo Sie möchten:

<iframe src="https://aube.news/widget?lang=de&theme=light"
        width="100%" height="180" frameborder="0"
        title="Aube — die gute Nachricht des Tages"
        loading="lazy"></iframe>

Parameter: lang=fr|en|es|pt|de|it und theme=light|dark. Das Widget trägt seine Quellenangabe bereits und öffnet den Artikel auf Aube in einem neuen Tab.

Vorschau