{"openapi":"3.1.0","jsonSchemaDialect":"https://spec.openapis.org/oas/3.1/dialect/base","info":{"title":"spacy.cloud Tech-News API","version":"1.1.0","summary":"Tägliche Tech-News und die Atlassian-Woche als JSON und Markdown.","description":"Nur lesend, ohne Schlüssel. Jede Ausgabe enthält Titel, Link, Quelle und eine automatisch erstellte deutsche Kurzfassung pro Eintrag. Kurzfassungen können Fehler enthalten, maßgeblich ist der verlinkte Originalartikel.","contact":{"name":"spacy.cloud","url":"https://spacy.cloud/impressum"}},"servers":[{"url":"https://news.spacy.cloud","description":"Produktion"}],"externalDocs":{"description":"Dokumentation","url":"https://news.spacy.cloud/api/v1/docs"},"tags":[{"name":"Ausgaben","description":"Tagesausgaben und Atlassian-Wochen, einzeln als JSON oder Markdown."},{"name":"Einträge","description":"Einzelne Meldungen aus allen Ausgaben, gefiltert oder durchsucht."},{"name":"Betrieb","description":"Übersicht, Zustand und diese Beschreibung."},{"name":"MCP","description":"Dieselben Daten als Model-Context-Protocol-Server für KI-Assistenten."}],"paths":{"/api/v1/issues":{"get":{"operationId":"listIssues","tags":["Ausgaben"],"summary":"Ausgaben auflisten","description":"Alle veröffentlichten Ausgaben, neueste zuerst (am selben Tag die Tagesausgabe vor der Atlassian-Woche).","parameters":[{"$ref":"#/components/parameters/lang"},{"$ref":"#/components/parameters/kind"},{"$ref":"#/components/parameters/since"},{"$ref":"#/components/parameters/until"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"}],"responses":{"200":{"description":"Eine Seite der Liste.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/Last-Modified"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Link":{"$ref":"#/components/headers/Link"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueList"},"example":{"data":[{"id":"2026-10-29","lang":"de","date":"2026-10-29","kind":"day","week":null,"title":"Tech-News 29.10.2026","item_count":1,"url":"https://news.spacy.cloud/de/day/2026-10-29","api_url":"https://news.spacy.cloud/api/v1/issues/2026-10-29","md_url":"https://news.spacy.cloud/api/v1/issues/2026-10-29.md"}],"meta":{"total":60,"count":1,"limit":1,"offset":0},"links":{"self":"https://news.spacy.cloud/api/v1/issues?limit=1&offset=0","first":"https://news.spacy.cloud/api/v1/issues?limit=1&offset=0","next":"https://news.spacy.cloud/api/v1/issues?limit=1&offset=1","last":"https://news.spacy.cloud/api/v1/issues?limit=1&offset=59"}}}}},"304":{"$ref":"#/components/responses/NotModified"},"400":{"$ref":"#/components/responses/BadRequest"},"406":{"$ref":"#/components/responses/NotAcceptable"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-example":"/api/v1/issues?kind=day&limit=5"}},"/api/v1/issues/latest":{"get":{"operationId":"getLatestIssue","tags":["Ausgaben"],"summary":"Neueste Ausgabe","description":"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.","parameters":[{"$ref":"#/components/parameters/lang"},{"$ref":"#/components/parameters/kind"},{"$ref":"#/components/parameters/accept"}],"responses":{"200":{"$ref":"#/components/responses/Issue"},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"400":{"$ref":"#/components/responses/BadRequest"},"406":{"$ref":"#/components/responses/NotAcceptable"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-example":"/api/v1/issues/latest"}},"/api/v1/issues/{id}":{"get":{"operationId":"getIssue","tags":["Ausgaben"],"summary":"Eine Ausgabe","description":"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`).","parameters":[{"$ref":"#/components/parameters/issueId"},{"$ref":"#/components/parameters/lang"},{"$ref":"#/components/parameters/accept"}],"responses":{"200":{"$ref":"#/components/responses/Issue"},"304":{"$ref":"#/components/responses/NotModified"},"404":{"$ref":"#/components/responses/NotFound"},"400":{"$ref":"#/components/responses/BadRequest"},"406":{"$ref":"#/components/responses/NotAcceptable"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-example":"/api/v1/issues/2026-10-29.md"}},"/api/v1/items":{"get":{"operationId":"listItems","tags":["Einträge"],"summary":"Einträge filtern","description":"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).","parameters":[{"$ref":"#/components/parameters/lang"},{"$ref":"#/components/parameters/kind"},{"$ref":"#/components/parameters/since"},{"$ref":"#/components/parameters/until"},{"$ref":"#/components/parameters/topic"},{"$ref":"#/components/parameters/top"},{"$ref":"#/components/parameters/qOptional"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"}],"responses":{"200":{"description":"Eine Seite der Trefferliste.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/Last-Modified"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Link":{"$ref":"#/components/headers/Link"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemList"},"example":{"data":[{"id":"5fb52d77453c24dc","title":"Beispiel-Release 1.2","url":"https://example.com/releases/1.2","source":"Example Releases","topic":"local","section":"Top 5","rank":1,"summary":"Version 1.2 läuft schneller und unterstützt neue Modelle.","published_at":"2026-10-29T02:54:11.000Z","hn":{"points":120,"url":"https://news.ycombinator.com/item?id=1"},"issue":"2026-10-29","kind":"day","date":"2026-10-29","issue_url":"https://news.spacy.cloud/de/day/2026-10-29"}],"meta":{"total":12,"count":1,"limit":1,"offset":0},"links":{"self":"https://news.spacy.cloud/api/v1/items?q=release&limit=1&offset=0","first":"https://news.spacy.cloud/api/v1/items?q=release&limit=1&offset=0","next":"https://news.spacy.cloud/api/v1/items?q=release&limit=1&offset=1","last":"https://news.spacy.cloud/api/v1/items?q=release&limit=1&offset=11"}}}}},"304":{"$ref":"#/components/responses/NotModified"},"400":{"$ref":"#/components/responses/BadRequest"},"406":{"$ref":"#/components/responses/NotAcceptable"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-example":"/api/v1/items?topic=local&since=2026-10-25&top=true"}},"/api/v1/search":{"get":{"operationId":"searchItems","tags":["Einträge"],"summary":"Suchen","description":"Wie `/items`, aber `q` ist Pflicht und die besten Treffer kommen zuerst: mehr Suchwörter im Titel, dann neuer.","parameters":[{"$ref":"#/components/parameters/q"},{"$ref":"#/components/parameters/lang"},{"$ref":"#/components/parameters/kind"},{"$ref":"#/components/parameters/since"},{"$ref":"#/components/parameters/until"},{"$ref":"#/components/parameters/topic"},{"$ref":"#/components/parameters/top"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/offset"}],"responses":{"200":{"description":"Eine Seite der Trefferliste.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/Last-Modified"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Link":{"$ref":"#/components/headers/Link"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemList"},"example":{"data":[{"id":"5fb52d77453c24dc","title":"Beispiel-Release 1.2","url":"https://example.com/releases/1.2","source":"Example Releases","topic":"local","section":"Top 5","rank":1,"summary":"Version 1.2 läuft schneller und unterstützt neue Modelle.","published_at":"2026-10-29T02:54:11.000Z","hn":{"points":120,"url":"https://news.ycombinator.com/item?id=1"},"issue":"2026-10-29","kind":"day","date":"2026-10-29","issue_url":"https://news.spacy.cloud/de/day/2026-10-29"}],"meta":{"total":12,"count":1,"limit":1,"offset":0},"links":{"self":"https://news.spacy.cloud/api/v1/items?q=release&limit=1&offset=0","first":"https://news.spacy.cloud/api/v1/items?q=release&limit=1&offset=0","next":"https://news.spacy.cloud/api/v1/items?q=release&limit=1&offset=1","last":"https://news.spacy.cloud/api/v1/items?q=release&limit=1&offset=11"}}}}},"304":{"$ref":"#/components/responses/NotModified"},"400":{"$ref":"#/components/responses/BadRequest"},"406":{"$ref":"#/components/responses/NotAcceptable"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/Unavailable"}},"x-example":"/api/v1/search?q=copilot&limit=10"}},"/api/v1/health":{"get":{"operationId":"getHealth","tags":["Betrieb"],"summary":"Zustand","description":"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.","responses":{"200":{"description":"Erreichbar, `status` ist `pass` oder `warn`.","content":{"application/health+json":{"schema":{"$ref":"#/components/schemas/Health"},"example":{"status":"pass","version":"1","releaseId":"1.1.0","serviceId":"spacy-tech-news","description":"spacy.cloud Tech-News API","checks":{"data:issues":[{"componentId":"de","observedValue":60,"status":"pass","time":"2026-10-29T08:00:00+00:00"}],"data:updated":[{"componentId":"de","observedValue":3600,"observedUnit":"s","status":"pass","time":"2026-10-29T08:00:00+00:00"}],"data:latestDay":[{"componentId":"de","observedValue":0,"observedUnit":"d","status":"pass","time":"2026-10-29T08:00:00+00:00","affectedEndpoints":["https://news.spacy.cloud/api/v1/issues/2026-10-29"]}]},"links":{"about":"https://news.spacy.cloud/api/v1/docs","self":"https://news.spacy.cloud/api/v1/health"}}}}},"406":{"$ref":"#/components/responses/NotAcceptable"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Keine Daten lesbar, `status` ist `fail`.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"}},"content":{"application/health+json":{"schema":{"$ref":"#/components/schemas/Health"}}}}},"x-example":"/api/v1/health"}},"/api/v1":{"get":{"operationId":"getIndex","tags":["Betrieb"],"summary":"Übersicht","description":"Version und Links auf alle Einstiegspunkte (`/api/v1`).","responses":{"200":{"description":"Übersicht.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/Last-Modified"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Index"}}}},"304":{"$ref":"#/components/responses/NotModified"},"406":{"$ref":"#/components/responses/NotAcceptable"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"x-example":"/api/v1"}},"/api/v1/openapi.json":{"get":{"operationId":"getOpenApi","tags":["Betrieb"],"summary":"OpenAPI-Beschreibung","description":"Diese Beschreibung als OpenAPI 3.1 (JSON), z. B. für Code-Generatoren oder API-Clients. Dieselbe als YAML unter `/api/v1/openapi.yaml`.","responses":{"200":{"description":"OpenAPI-Dokument.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/Last-Modified"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"}},"content":{"application/json":{"schema":{"type":"object"}}}},"304":{"$ref":"#/components/responses/NotModified"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"x-example":"/api/v1/openapi.json"}},"/api/v1/openapi.yaml":{"get":{"operationId":"getOpenApiYaml","tags":["Betrieb"],"summary":"OpenAPI-Beschreibung (YAML)","description":"Dieselbe Beschreibung als YAML (`application/yaml`), etwa zum Import in Insomnia oder Yaak. Liegt auch im Repository als `public/api/openapi.yaml`.","responses":{"200":{"description":"OpenAPI-Dokument.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/Last-Modified"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"}},"content":{"application/yaml":{"schema":{"type":"string"}}}},"304":{"$ref":"#/components/responses/NotModified"},"429":{"$ref":"#/components/responses/TooManyRequests"}},"x-example":"/api/v1/openapi.yaml"}},"/mcp":{"post":{"operationId":"mcp","tags":["MCP"],"summary":"MCP (streamable HTTP)","description":"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.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":["object","array"]},"examples":{"initialize":{"summary":"Verbindung aufbauen","value":{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"beispiel","version":"1.0"}}}},"tools-list":{"summary":"Tools auflisten","value":{"jsonrpc":"2.0","id":2,"method":"tools/list"}},"latest":{"summary":"Neueste Ausgabe","value":{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"latest","arguments":{}}}},"search":{"summary":"Suchen","value":{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"search","arguments":{"query":"copilot","days":7}}}}}}}},"responses":{"200":{"description":"JSON-RPC-Antwort(en).","content":{"application/json":{"schema":{"type":["object","array"]}}}},"202":{"description":"Nur Benachrichtigungen, keine Antwort."},"400":{"description":"Leerer Body (Problem Details) oder kein JSON (JSON-RPC-Fehler -32700)."},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}}},"components":{"parameters":{"issueId":{"name":"id","in":"path","required":true,"description":"`JJJJ-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.","schema":{"type":"string","pattern":"^(\\d{4}-\\d{2}-\\d{2}|atlassian-\\d{4}-KW\\d{2}|latest|latest-atlassian)(\\.json|\\.md)?$"},"example":"2026-10-29"},"lang":{"name":"lang","in":"query","description":"Sprache. Bisher gibt es nur `de`.","schema":{"type":"string","enum":["de"],"default":"de"}},"kind":{"name":"kind","in":"query","description":"`day` (Tagesausgabe) oder `atlassian` (Atlassian-Woche). Ohne: beide.","schema":{"type":"string","enum":["day","atlassian"]}},"since":{"name":"since","in":"query","description":"Nur Ausgaben ab diesem Datum (einschließlich).","schema":{"type":"string","format":"date"},"example":"2026-10-25"},"until":{"name":"until","in":"query","description":"Nur Ausgaben bis zu diesem Datum (einschließlich).","schema":{"type":"string","format":"date"}},"topic":{"name":"topic","in":"query","description":"Thema eines Eintrags. Tagesausgabe: `local`, `coding`, `labs`, `research`, `tech`; Atlassian: `entwickler`, `produkt`, `stoerung`.","schema":{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,29}$","maxLength":30}},"top":{"name":"top","in":"query","description":"Nur die Top 5 jeder Tagesausgabe (Einträge mit `rank`).","schema":{"type":"boolean","default":false}},"q":{"name":"q","in":"query","required":true,"description":"Suchwörter; jedes muss vorkommen.","schema":{"type":"string","minLength":1,"maxLength":200},"example":"copilot"},"qOptional":{"name":"q","in":"query","description":"Nur Einträge, die jedes dieser Wörter enthalten.","schema":{"type":"string","maxLength":200}},"limit":{"name":"limit","in":"query","description":"Einträge pro Seite.","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},"offset":{"name":"offset","in":"query","description":"Wie viele Einträge übersprungen werden.","schema":{"type":"integer","minimum":0,"maximum":100000,"default":0}},"accept":{"name":"Accept","in":"header","description":"`application/json` (Standard) oder `text/markdown`.","schema":{"type":"string"}}},"headers":{"ETag":{"description":"Prüfsumme der Darstellung; mit `If-None-Match` gibt es 304, solange sie gleich bleibt.","schema":{"type":"string"}},"Last-Modified":{"description":"Zeitpunkt der letzten Aktualisierung der Daten.","schema":{"type":"string"}},"Cache-Control":{"description":"`public, max-age=300` für eine feste Ausgabe, `max-age=60` für Listen und `latest`.","schema":{"type":"string"}},"Link":{"description":"RFC 8288: `first`, `prev`, `next`, `last` der Paginierung.","schema":{"type":"string"}},"Retry-After":{"description":"Sekunden bis zum nächsten Versuch.","schema":{"type":"integer"}},"Allow":{"description":"Erlaubte Methoden.","schema":{"type":"string"}}},"responses":{"Issue":{"description":"Die Ausgabe als JSON oder Markdown.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/Last-Modified"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"Content-Location":{"description":"Bei `latest`: feste Adresse der Ausgabe.","schema":{"type":"string","format":"uri"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Issue"},"example":{"id":"2026-10-29","lang":"de","date":"2026-10-29","kind":"day","week":null,"title":"Tech-News 29.10.2026","intro":"Ein Tag mit vielen Releases.","item_count":1,"path":"/de/day/2026-10-29","url":"https://news.spacy.cloud/de/day/2026-10-29","api_url":"https://news.spacy.cloud/api/v1/issues/2026-10-29","md_url":"https://news.spacy.cloud/api/v1/issues/2026-10-29.md","items":[{"id":"5fb52d77453c24dc","title":"Beispiel-Release 1.2","url":"https://example.com/releases/1.2","source":"Example Releases","topic":"local","section":"Top 5","rank":1,"summary":"Version 1.2 läuft schneller und unterstützt neue Modelle.","published_at":"2026-10-29T02:54:11.000Z","hn":{"points":120,"url":"https://news.ycombinator.com/item?id=1"}}]}},"text/markdown":{"schema":{"type":"string"},"example":"---\ntitle: \"Tech-News 29.10.2026\"\ndate: 2026-10-29\nkind: day\nsource: https://news.spacy.cloud/de/day/2026-10-29\n---\n\n# Tech-News 29.10.2026\n\nEin Tag mit vielen Releases.\n\n*Automatisch erstellt aus öffentlichen Quellen, kann Fehler enthalten. Die Kurzfassungen sind eigene Formulierungen, maßgeblich ist der verlinkte Originalartikel.*\n\n## Top 5\n\n1. **[Beispiel-Release 1.2](<https://example.com/releases/1.2>)** · Example Releases · [HN 120](<https://news.ycombinator.com/item?id=1>)\n   Version 1.2 läuft schneller und unterstützt neue Modelle.\n\n---\n\nspacy.cloud Tech-News · https://news.spacy.cloud/de/day/2026-10-29\n"}}},"NotModified":{"description":"Unverändert seit `If-None-Match` bzw. `If-Modified-Since`, ohne Body.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Last-Modified":{"$ref":"#/components/headers/Last-Modified"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"}}},"BadRequest":{"description":"Ungültiger Parameter; `errors` nennt jeden mit Grund.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"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/issues/2026-10-29","errors":[{"name":"since","reason":"Datum im Format JJJJ-MM-TT"}]}}}},"NotFound":{"description":"Ausgabe oder Adresse gibt es nicht.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://news.spacy.cloud/api/v1/docs#nicht-gefunden","title":"Nicht gefunden","status":404,"detail":"Keine Ausgabe 2026-10-29.","instance":"/api/v1/issues/2026-10-29"}}}},"MethodNotAllowed":{"description":"Methode nicht erlaubt; `Allow` nennt die erlaubten.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://news.spacy.cloud/api/v1/docs#methode-nicht-erlaubt","title":"Methode nicht erlaubt","status":405,"detail":"Erlaubt sind GET, HEAD, OPTIONS.","instance":"/api/v1/issues/2026-10-29"}}},"headers":{"Allow":{"$ref":"#/components/headers/Allow"}}},"NotAcceptable":{"description":"Der Accept-Header schließt jedes lieferbare Format aus.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://news.spacy.cloud/api/v1/docs#format-nicht-verfuegbar","title":"Format nicht verfügbar","status":406,"detail":"Dieser Endpunkt liefert application/json, text/markdown. Bitte den Accept-Header anpassen.","instance":"/api/v1/issues/2026-10-29"}}}},"PayloadTooLarge":{"description":"Body größer als erlaubt.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://news.spacy.cloud/api/v1/docs#anfrage-zu-gross","title":"Anfrage zu groß","status":413,"detail":"Höchstens 16 KB pro Anfrage.","instance":"/api/v1/issues/2026-10-29"}}}},"UnsupportedMediaType":{"description":"Body ist kein `application/json`.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://news.spacy.cloud/api/v1/docs#inhaltstyp-nicht-unterstuetzt","title":"Inhaltstyp nicht unterstützt","status":415,"detail":"MCP erwartet Content-Type: application/json.","instance":"/api/v1/issues/2026-10-29"}}}},"TooManyRequests":{"description":"Zu viele Anfragen von dieser IP-Adresse.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://news.spacy.cloud/api/v1/docs#zu-viele-anfragen","title":"Zu viele Anfragen","status":429,"detail":"Zu viele Anfragen von dieser IP-Adresse. Bitte nach Retry-After Sekunden erneut versuchen.","instance":"/api/v1/issues/2026-10-29"}}},"headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"}}},"Unavailable":{"description":"Daten werden gerade aktualisiert oder sind nicht lesbar.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://news.spacy.cloud/api/v1/docs#voruebergehend-nicht-verfuegbar","title":"Vorübergehend nicht verfügbar","status":503,"detail":"Die Daten werden gerade aktualisiert. Bitte in einer Minute erneut versuchen.","instance":"/api/v1/issues/2026-10-29"}}},"headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"}}}},"schemas":{"Item":{"type":"object","required":["id","title","url","source","topic","section","rank","summary","published_at","hn"],"properties":{"id":{"type":"string","description":"Stabiler Hash des Links."},"title":{"type":"string","maxLength":200},"url":{"type":["string","null"],"format":"uri","description":"Originalartikel."},"source":{"type":["string","null"],"description":"Name der Quelle."},"topic":{"type":["string","null"],"description":"Thema, siehe Parameter `topic`."},"section":{"type":["string","null"],"description":"Abschnitt auf der Seite, z. B. „Top 5“."},"rank":{"type":["integer","null"],"minimum":1,"maximum":5,"description":"Platz in den Top 5, sonst null."},"summary":{"type":["string","null"],"maxLength":400,"description":"Deutsche Kurzfassung, automatisch erstellt."},"published_at":{"type":["string","null"],"format":"date-time"},"hn":{"type":["object","null"],"description":"Diskussion auf Hacker News.","properties":{"points":{"type":"integer"},"url":{"type":"string","format":"uri"}}}}},"ItemHit":{"allOf":[{"$ref":"#/components/schemas/Item"},{"type":"object","required":["issue","kind","date","issue_url"],"properties":{"issue":{"type":"string","description":"ID der Ausgabe."},"kind":{"type":"string","enum":["day","atlassian"]},"date":{"type":"string","format":"date"},"issue_url":{"type":"string","format":"uri","description":"Seite der Ausgabe."}}}]},"IssueSummary":{"type":"object","required":["id","lang","date","kind","week","title","item_count","url","api_url","md_url"],"properties":{"id":{"type":"string","example":"2026-10-29"},"lang":{"type":"string","enum":["de"]},"date":{"type":"string","format":"date","description":"Tag der Ausgabe; bei der Atlassian-Woche der Montag danach."},"kind":{"type":"string","enum":["day","atlassian"]},"week":{"type":["string","null"],"pattern":"^\\d{4}-KW\\d{2}$","description":"Kalenderwoche der Atlassian-Ausgabe."},"title":{"type":"string"},"item_count":{"type":"integer","minimum":0},"url":{"type":"string","format":"uri","description":"Seite."},"api_url":{"type":"string","format":"uri","description":"Diese Ausgabe als JSON."},"md_url":{"type":"string","format":"uri","description":"Diese Ausgabe als Markdown."}}},"Issue":{"allOf":[{"$ref":"#/components/schemas/IssueSummary"},{"type":"object","required":["intro","path","items"],"properties":{"intro":{"type":["string","null"],"maxLength":500},"path":{"type":"string","description":"Pfad der Seite."},"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}}}}]},"Page":{"type":"object","required":["meta","links"],"properties":{"meta":{"type":"object","required":["total","count","limit","offset"],"properties":{"total":{"type":"integer"},"count":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}},"links":{"type":"object","required":["self","first","last"],"properties":{"self":{"type":"string","format":"uri"},"first":{"type":"string","format":"uri"},"prev":{"type":"string","format":"uri"},"next":{"type":"string","format":"uri"},"last":{"type":"string","format":"uri"}}}}},"IssueList":{"allOf":[{"$ref":"#/components/schemas/Page"},{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/IssueSummary"}}}}]},"ItemList":{"allOf":[{"$ref":"#/components/schemas/Page"},{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ItemHit"}}}}]},"Problem":{"type":"object","description":"RFC 9457 Problem Details.","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri","description":"Verweist auf die Erklärung in dieser Dokumentation."},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string","description":"Pfad der Anfrage."},"errors":{"type":"array","description":"Bei 400: jeder ungültige Parameter.","items":{"type":"object","required":["name","reason"],"properties":{"name":{"type":"string"},"reason":{"type":"string"}}}}}},"Health":{"type":"object","required":["status","checks"],"properties":{"status":{"type":"string","enum":["pass","warn","fail"]},"version":{"type":"string"},"releaseId":{"type":"string"},"serviceId":{"type":"string"},"description":{"type":"string"},"checks":{"type":"object","description":"`data:issues` (Anzahl), `data:updated` (Sekunden seit der letzten Aktualisierung), `data:latestDay` und `data:latestWeek` (Tage seit der neuesten Ausgabe), je Sprache.","additionalProperties":{"type":"array","items":{"type":"object","properties":{"componentId":{"type":"string"},"observedValue":{},"observedUnit":{"type":"string"},"status":{"type":"string","enum":["pass","warn","fail"]},"time":{"type":"string","format":"date-time"},"output":{"type":"string"}}}}},"links":{"type":"object"},"release":{"type":"object","description":"Ausgerollter Stand der Seite: Version, Commit (12 Zeichen) und Zeitpunkt. Fehlt, solange nichts automatisch ausgerollt wurde.","properties":{"version":{"type":"string"},"commit":{"type":"string"},"deployedAt":{"type":"string","format":"date-time"}}}}},"Index":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"languages":{"type":"array","items":{"type":"string"}},"docs":{"type":"string","format":"uri"},"openapi":{"type":"string","format":"uri"},"links":{"type":"object","additionalProperties":{"type":"string","format":"uri"}}}}}}}