Nachrichten-Schnittstelle für Partner

Zugang

Nach Abstimmung richtet die Redaktion einen einzelnen, widerrufbaren Zugang für deine Organisation ein. Zugangstokens gehören ausschließlich auf deinen Server und niemals in öffentlich ausgelieferten JavaScript-Code.

Nachricht einreichen

POST https://cfsmag.de/api/v1/submissions

Header: Content-Type: application/json, Authorization: Bearer DEIN_ZUGANGSTOKEN und Idempotency-Key mit einer eindeutigen Kennung aus 8 bis 120 Buchstaben, Ziffern, Punkten, Doppelpunkten, Unter- oder Bindestrichen.

{
  "name": "Name der verantwortlichen Person",
  "email": "redaktion@example.org",
  "title": "Titel der eigenen Nachricht",
  "body": "Eigener Nachrichtentext mit mindestens fünfzig Zeichen und geklärten Nutzungsrechten.",
  "url": "https://example.org/originalmeldung",
  "kind": "article",
  "topic": "long-covid",
  "package": "basis",
  "rights": true,
  "privacy": true
}

Weitere Arten: event, correction, partnership. Für Veranstaltungen kann event_date als JJJJ-MM-TT übermittelt werden. Themenkennungen stehen unter Themen in der jeweiligen URL. Das Paket unterstuetzer stellt nur eine Anfrage dar.

Antwort und Status

Neue Eingänge: HTTP 201 mit reference und status_endpoint. Derselbe Idempotency-Key beim selben Zugang: HTTP 200 und duplicate: true, ohne zweiten Eingang. Geänderte Inhalte benötigen eine neue Kennung.

GET https://cfsmag.de/api/v1/submissions/REFERENZ mit demselben Bearer-Token liefert den redaktionellen Status. Fremde Einreichungen sind nicht zugänglich.

Grenzen und Fehler

Maximal 30 Einreichungsaufrufe pro Stunde und Zugang/IP.
Text: 50 bis 20.000 Zeichen; Titel: 5 bis 180 Zeichen.
401: Zugang fehlt oder ist widerrufen; 404: Status nicht verfügbar.
422: Angaben ungültig; 429: Limit erreicht. Bei 429 später erneut mit derselben Kennung versuchen.
Nur eigene oder ausreichend lizenzierte Texte. Keine vertraulichen Gesundheitsdaten.

Mit rights: true bestätigst du die erforderlichen Rechte und gestattest die nicht ausschließliche Veröffentlichung und redaktionelle Bearbeitung. privacy: true bestätigt die Kenntnis der Datenschutzhinweise. Bilder werden nach gesonderter Rechteprüfung von der Redaktion übernommen; externe Bildadressen werden nicht automatisch heruntergeladen.

API-Zugang anfragen →