spacy.cloudTech-News

Für Entwickler · Version 1

Tech-News API

Alle Ausgaben und Einträge der Tech-News als JSON und Markdown: offen, nur lesend, ohne Schlüssel. Dazu ein MCP-Server für KI-Assistenten.

Basis-URL
news.spacy.cloud/api/v1
Formate
JSON · Markdown
OpenAPI 3.1
JSON · YAML
Zustand
Health
Version
1.1.0

Automatisch erstellt aus öffentlichen Quellen, kann Fehler enthalten. Die Kurzfassungen sind eigene Formulierungen, maßgeblich ist der verlinkte Originalartikel.

Schnellstartdrei Aufrufe

Die neueste Tagesausgabe als JSON, dieselbe als Markdown und eine Suche über alle Ausgaben:

curl https://news.spacy.cloud/api/v1/issues/latest
curl https://news.spacy.cloud/api/v1/issues/latest.md
curl 'https://news.spacy.cloud/api/v1/search?q=copilot&limit=5'

Eine Ausgabe hat dieselbe ID wie ihre Seite: 2026-10-29 für /de/day/2026-10-29, atlassian-2026-KW43 für /de/week/2026-KW43.

AusgabenTagesausgaben und Atlassian-Wochen, einzeln als JSON oder Markdown.

GET/api/v1/issues

Ausgaben auflisten

Alle veröffentlichten Ausgaben, neueste zuerst (am selben Tag die Tagesausgabe vor der Atlassian-Woche).

ParameterTypBedeutung
langquerydeSprache. Bisher gibt es nur de. Standard "de"
kindqueryday | atlassianday (Tagesausgabe) oder atlassian (Atlassian-Woche). Ohne: beide.
sincequerydateNur Ausgaben ab diesem Datum (einschließlich).
untilquerydateNur Ausgaben bis zu diesem Datum (einschließlich).
limitqueryintegerEinträge pro Seite. Standard 50
offsetqueryintegerWie viele Einträge übersprungen werden. Standard 0
  • 200 Eine Seite der Liste.
  • 304 Unverändert seit If-None-Match bzw. If-Modified-Since, ohne Body.
  • 400 Ungültiger Parameter; errors nennt jeden mit Grund.
  • 406 Der Accept-Header schließt jedes lieferbare Format aus.
  • 429 Zu viele Anfragen von dieser IP-Adresse.
  • 503 Daten werden gerade aktualisiert oder sind nicht lesbar.
curl -i https://news.spacy.cloud/api/v1/issues?kind=day&limit=5

GET/api/v1/issues/latest

Neueste Ausgabe

Die neueste Tagesausgabe, mit kind=atlassian die neueste Atlassian-Woche. Content-Location nennt die feste Adresse der Ausgabe. Format wie bei /issues/{id}; /issues/latest.md liefert Markdown.

ParameterTypBedeutung
langquerydeSprache. Bisher gibt es nur de. Standard "de"
kindqueryday | atlassianday (Tagesausgabe) oder atlassian (Atlassian-Woche). Ohne: beide.
Acceptheaderstringapplication/json (Standard) oder text/markdown.
  • 200 Die Ausgabe als JSON oder Markdown.
  • 304 Unverändert seit If-None-Match bzw. If-Modified-Since, ohne Body.
  • 404 Ausgabe oder Adresse gibt es nicht.
  • 400 Ungültiger Parameter; errors nennt jeden mit Grund.
  • 406 Der Accept-Header schließt jedes lieferbare Format aus.
  • 429 Zu viele Anfragen von dieser IP-Adresse.
  • 503 Daten werden gerade aktualisiert oder sind nicht lesbar.
curl -i https://news.spacy.cloud/api/v1/issues/latest

GET/api/v1/issues/{id}

Eine Ausgabe

Eine Ausgabe mit allen Einträgen in der Reihenfolge der Seite (Top 5, dann Abschnitte). Als Markdown mit .md am Ende oder Accept: text/markdown, .json erzwingt JSON. Ohne Endung entscheidet der Accept-Header (Vary: Accept).

ParameterTypBedeutung
idpathstringJJJJ-MM-TT für eine Tagesausgabe, atlassian-JJJJ-KWnn für eine Atlassian-Woche, latest oder latest-atlassian; optional mit .json oder .md am Ende. Pflicht
langquerydeSprache. Bisher gibt es nur de. Standard "de"
Acceptheaderstringapplication/json (Standard) oder text/markdown.
  • 200 Die Ausgabe als JSON oder Markdown.
  • 304 Unverändert seit If-None-Match bzw. If-Modified-Since, ohne Body.
  • 404 Ausgabe oder Adresse gibt es nicht.
  • 400 Ungültiger Parameter; errors nennt jeden mit Grund.
  • 406 Der Accept-Header schließt jedes lieferbare Format aus.
  • 429 Zu viele Anfragen von dieser IP-Adresse.
  • 503 Daten werden gerade aktualisiert oder sind nicht lesbar.
curl -i https://news.spacy.cloud/api/v1/issues/2026-10-29.md

EinträgeEinzelne Meldungen aus allen Ausgaben, gefiltert oder durchsucht.

GET/api/v1/items

Einträge filtern

Einträge aller Ausgaben, neueste Ausgabe zuerst, innerhalb einer Ausgabe in Seitenreihenfolge. q filtert auf Einträge, die jedes Wort enthalten (Titel, Kurzfassung, Quelle, Thema; ohne Groß- und Kleinschreibung).

ParameterTypBedeutung
langquerydeSprache. Bisher gibt es nur de. Standard "de"
kindqueryday | atlassianday (Tagesausgabe) oder atlassian (Atlassian-Woche). Ohne: beide.
sincequerydateNur Ausgaben ab diesem Datum (einschließlich).
untilquerydateNur Ausgaben bis zu diesem Datum (einschließlich).
topicquerystringThema eines Eintrags. Tagesausgabe: local, coding, labs, research, tech; Atlassian: entwickler, produkt, stoerung.
topquerybooleanNur die Top 5 jeder Tagesausgabe (Einträge mit rank). Standard false
qquerystringNur Einträge, die jedes dieser Wörter enthalten.
limitqueryintegerEinträge pro Seite. Standard 50
offsetqueryintegerWie viele Einträge übersprungen werden. Standard 0
  • 200 Eine Seite der Trefferliste.
  • 304 Unverändert seit If-None-Match bzw. If-Modified-Since, ohne Body.
  • 400 Ungültiger Parameter; errors nennt jeden mit Grund.
  • 406 Der Accept-Header schließt jedes lieferbare Format aus.
  • 429 Zu viele Anfragen von dieser IP-Adresse.
  • 503 Daten werden gerade aktualisiert oder sind nicht lesbar.
curl -i https://news.spacy.cloud/api/v1/items?topic=local&since=2026-10-25&top=true

GET/api/v1/search

Suchen

Wie /items, aber q ist Pflicht und die besten Treffer kommen zuerst: mehr Suchwörter im Titel, dann neuer.

ParameterTypBedeutung
qquerystringSuchwörter; jedes muss vorkommen. Pflicht
langquerydeSprache. Bisher gibt es nur de. Standard "de"
kindqueryday | atlassianday (Tagesausgabe) oder atlassian (Atlassian-Woche). Ohne: beide.
sincequerydateNur Ausgaben ab diesem Datum (einschließlich).
untilquerydateNur Ausgaben bis zu diesem Datum (einschließlich).
topicquerystringThema eines Eintrags. Tagesausgabe: local, coding, labs, research, tech; Atlassian: entwickler, produkt, stoerung.
topquerybooleanNur die Top 5 jeder Tagesausgabe (Einträge mit rank). Standard false
limitqueryintegerEinträge pro Seite. Standard 50
offsetqueryintegerWie viele Einträge übersprungen werden. Standard 0
  • 200 Eine Seite der Trefferliste.
  • 304 Unverändert seit If-None-Match bzw. If-Modified-Since, ohne Body.
  • 400 Ungültiger Parameter; errors nennt jeden mit Grund.
  • 406 Der Accept-Header schließt jedes lieferbare Format aus.
  • 429 Zu viele Anfragen von dieser IP-Adresse.
  • 503 Daten werden gerade aktualisiert oder sind nicht lesbar.
curl -i https://news.spacy.cloud/api/v1/search?q=copilot&limit=10

BetriebÜbersicht, Zustand und diese Beschreibung.

GET/api/v1/health

Zustand

Datenstand nach dem Health-Check-Format (application/health+json): Zahl der Ausgaben, Alter der letzten Aktualisierung und der neuesten Ausgaben. pass und warn (Daten älter als erwartet) kommen mit 200, fail (keine Daten lesbar) mit 503. Nie gecacht.

  • 200 Erreichbar, status ist pass oder warn.
  • 406 Der Accept-Header schließt jedes lieferbare Format aus.
  • 429 Zu viele Anfragen von dieser IP-Adresse.
  • 503 Keine Daten lesbar, status ist fail.
curl -i https://news.spacy.cloud/api/v1/health

GET/api/v1

Übersicht

Version und Links auf alle Einstiegspunkte (/api/v1).

  • 200 Übersicht.
  • 304 Unverändert seit If-None-Match bzw. If-Modified-Since, ohne Body.
  • 406 Der Accept-Header schließt jedes lieferbare Format aus.
  • 429 Zu viele Anfragen von dieser IP-Adresse.
curl -i https://news.spacy.cloud/api/v1

GET/api/v1/openapi.json

OpenAPI-Beschreibung

Diese Beschreibung als OpenAPI 3.1 (JSON), z. B. für Code-Generatoren oder API-Clients. Dieselbe als YAML unter /api/v1/openapi.yaml.

  • 200 OpenAPI-Dokument.
  • 304 Unverändert seit If-None-Match bzw. If-Modified-Since, ohne Body.
  • 429 Zu viele Anfragen von dieser IP-Adresse.
curl -i https://news.spacy.cloud/api/v1/openapi.json

GET/api/v1/openapi.yaml

OpenAPI-Beschreibung (YAML)

Dieselbe Beschreibung als YAML (application/yaml), etwa zum Import in Insomnia oder Yaak. Liegt auch im Repository als public/api/openapi.yaml.

  • 200 OpenAPI-Dokument.
  • 304 Unverändert seit If-None-Match bzw. If-Modified-Since, ohne Body.
  • 429 Zu viele Anfragen von dieser IP-Adresse.
curl -i https://news.spacy.cloud/api/v1/openapi.yaml

MCPDieselben Daten als Model-Context-Protocol-Server für KI-Assistenten.

POST/mcp

MCP (streamable HTTP)

JSON-RPC 2.0 nach dem Model Context Protocol, zustandslos, Antworten als JSON (kein SSE). Tools: latest, report (format: json|markdown), reports, search. Höchstens 20 Nachrichten pro Batch, 16 KB pro Anfrage.

  • 200 JSON-RPC-Antwort(en).
  • 202 Nur Benachrichtigungen, keine Antwort.
  • 400 Leerer Body (Problem Details) oder kein JSON (JSON-RPC-Fehler -32700).
  • 405 Methode nicht erlaubt; Allow nennt die erlaubten.
  • 413 Body größer als erlaubt.
  • 415 Body ist kein application/json.
  • 429 Zu viele Anfragen von dieser IP-Adresse.
curl -s https://news.spacy.cloud/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"latest","arguments":{}}}'

Konventionenfür alle Endpunkte

Formate

JSON kommt als application/json; charset=utf-8, Markdown als text/markdown; charset=utf-8, Fehler als application/problem+json, der Zustand als application/health+json. Felder heißen in snake_case, Zeiten sind ISO 8601 (UTC), Datumsangaben Berliner Ortszeit.

Methoden

Alle Endpunkte unter /api/ nehmen GET, HEAD und OPTIONS, /mcp nur POST. Andere Methoden geben 405 mit Allow. Eine Adresse mit Schrägstrich am Ende leitet per 308 auf die ohne um.

Paginierung

Listen kommen als {data, meta, links}. meta.total zählt alle Treffer, links und der Link-Header (RFC 8288) nennen first, prev, next und last. Steuern mit limit (1 bis 100, Standard 50) und offset.

Caching

Jede Antwort trägt ETag und Last-Modified. Mit If-None-Match bzw. If-Modified-Since antwortet die API mit 304 Not Modified ohne Body, solange sich nichts geändert hat. Cache-Control: eine feste Ausgabe 5 Minuten, Listen und latest 1 Minute, Beschreibung und Doku 1 Stunde, /health nie.

CORS

Alle Endpunkte unter /api/ erlauben Abrufe aus dem Browser von jeder Herkunft (Access-Control-Allow-Origin: *, ohne Cookies); OPTIONS beantwortet Preflights. /mcp sendet keine CORS-Header.

Grenzen

BereichRate pro IPBurst
/api/30 pro Minute20
/mcp60 pro Minute30
ganze Seite120 pro Minute, 20 gleichzeitige Verbindungen60

Darüber gibt es 429 mit Retry-After. Wer regelmäßig abruft, nutzt am besten If-None-Match: Ausgaben erscheinen einmal am Tag, die Atlassian-Woche montags.

Versionierung

Der Pfad trägt die Hauptversion (/api/v1). Neue Felder oder Endpunkte können ohne neue Version dazukommen; Clients sollten unbekannte Felder ignorieren. Was ein Feld entfernt oder umdeutet, kommt als /api/v2.

FehlerRFC 9457

Fehler kommen als Problem Details. type verweist auf die passende Erklärung hier, detail beschreibt den Einzelfall, instance ist der Pfad der Anfrage.

{
  "type": "https://news.spacy.cloud/api/v1/docs#ungueltige-anfrage",
  "title": "Ungültige Anfrage",
  "status": 400,
  "detail": "Mindestens ein Parameter ist ungültig, Details unter errors.",
  "instance": "/api/v1/items",
  "errors": [
    {
      "name": "since",
      "reason": "Datum im Format JJJJ-MM-TT"
    }
  ]
}

Alte Adressenfunktionieren weiter

Die Adressen, auf die die Seiten verlinken, bleiben dauerhaft. Die übrigen liefern ihr bisheriges Format mit den Headern Deprecation und Link: rel="successor-version"; neue Clients nutzen /api/v1.

BisherVersion 1Status
/api/de/day/{datum}/api/v1/issues/{datum}bleibt (Link der Seiten)
/api/de/day/md/{datum}.md/api/v1/issues/{datum}.mdbleibt (Copy MD)
/api/de/week/{JJJJ-KWnn}/api/v1/issues/atlassian-{JJJJ-KWnn}bleibt
/api/de/week/md/{JJJJ-KWnn}.md/api/v1/issues/atlassian-{JJJJ-KWnn}.mdbleibt
/api/reports.json/api/v1/issuesveraltet, altes Format
/api/reports/{id}.json/api/v1/issues/{id}veraltet
/api/items.json/api/v1/itemsveraltet, altes Format
/api/health/api/v1/healthveraltet, altes Format