REST-API-Endpoint

GET /v1/proofreading

Bis zu 100 aktuell sichtbari Vorschläg zur Textprüefig us de zuletscht geprüefte Artikel vo eme Tracker.

Anfrag

GET https://api.nowmetrix.com/v1/proofreading?site=TRACKER_ID&limit=50

Verwänded Si dä Endpunkt, zum d’neuschte aktuelle Vorschläg zur Textprüefig für en autorisierte Tracker abzrüefe. Ergebnis, wo als korrigiert markiert oder durch e aktivi Ignorierregel abdeckt sind, werde usgschlosse.

Authentifizierig

Bruucht en API-Key im Authorization-Header: Authorization: Bearer nm_YOUR_KEY. De Key muess Zuegriff uf d’angefordereti Tracker-ID ha.

Abfragparameter

Name Typ Erforderlich Beschriibig
site string erforderlich NowMetrix-Tracking-ID. De API-Key muess Zuegriff uf dä Tracker ha. Übergäbed Si nöd d’Publikationsdomain.
limit integer optional Maximali Anzahl Vorschläg. Standardmässig 50, begränzt uf 100.

Biispil mit cURL

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/proofreading?site=TRACKER_ID&limit=50"

Biispilantwort

{
  "site": "TRACKER_ID",
  "updated_at": "2026-01-15T09:30:00+00:00",
  "limit": 50,
  "count": 1,
  "issues": [
    {
      "id": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
      "checked_at": "2026-01-15T09:25:00+00:00",
      "article": {
        "title": "Example article",
        "url": "https://www.example.com/news/example-article"
      },
      "language": {
        "code": "en",
        "name": "English"
      },
      "category": {
        "code": "consistency",
        "label": "Article inconsistency"
      },
      "location": {
        "code": "body",
        "label": "Body"
      },
      "original": "Northwind Lab",
      "original_occurrence": 1,
      "correction": "Northwind Labs",
      "context": "The announcement was published by Northwind Lab on Monday.",
      "explanation": "The organization is named Northwind Labs elsewhere in the same article.",
      "confidence": "high"
    }
  ]
}

Antwortfelder

Feld Typ Beschriibig
site string Tracking-ID, wo für d’Anfrag verwendet worde isch.
updated_at string UTC-Ziitstempel, wo zeigt, wenn d’Nutzlast erstellt worde isch.
limit integer Effektivi Resultatbegränzig nach de Validierig und Begränzig.
count integer Anzahl vo de zrugggehne sichtbare Vorschläg.
issues[] array<object> Sichtbari Vorschläg, absteigend nach checked_at sortiert.
issues[].id string Nöd sprechendi, stabili Kennig für das Vorkommnis vom Vorschlag.
issues[].checked_at string UTC-Ziitstempel vo de Artikelprüefig, wo de aktuelle Vorschlag erzeugt het.
issues[].article object Artikeltitel und vollständigi URL. Interni Artikel-IDs werde nöd veröffentlicht.
issues[].language object Erkannte Spraachcode und Aazeigname.
issues[].category object Maschinell läsbare Kategoriecode und lokalisierti Bezeichnig. De consistency-Code bezeichnet Widersprüch im Artikel selber, zum Biispil bi Name oder sachliche Details wie Zahle, Datum, Uhrziite, Alter, Ort und Rolle.
issues[].location object Code vom Artikelabschnitt und lokalisierte Bezeichnig.
issues[].original string Originaltext, wo d’Textprüefig identifiziert het.
issues[].original_occurrence integer|null Vorkommnis vom Original innerhalb vom Kontext, ab 1 zellt. Bi ältere Ergebnis cha de Wert null sii, wenn sich wiederholte Text nöd eindeutig zueordne laht.
issues[].correction string Vorgschlageni Korrektur.
issues[].context string Normalisierte Artikelkontext mit begränzter Längi.
issues[].explanation string Erklärig zum Vorschlag.
issues[].confidence string Vertrauensstufe, wo vo de Textprüefig-Pipeline akzeptiert worde isch.

Aktualität und Caching

Antworte werded pro Tracker und Limit 30 Sekunde lang im Mikrocache gspeicheret. D’Antwort enthält X-NowMetrix-Microcache mit HIT oder MISS. checked_at isch d’Ziit vo de Artikelprüefig; dä Endpunkt isch kei fortlaufendi Historie vo de erschte Erkennigsziitpünkt.

Fehler

HTTP Code Beschriibig
400 site_required De erforderliche site-Parameter fehlt.
401 missing_token De Authorization-Header fehlt.
401 invalid_token De Token isch ungültig oder widerruefe worde.
403 site_not_authorized De API-Key het kei Zuegriff uf dä Tracker.
429 rate_limit_exceeded S Rate-Limit isch überschritte worde.
503 redis_unavailable S Realtime-Backend isch vorübergehend nöd verfüegbar.
409 proofreading_not_enabled D’Textprüefig isch für dä angeforderte Tracker nöd aktiviert.
500 encoding_failed D’Antwort het nöd codiert werde chönne.
503 database_unavailable D’Datenbank für d’Textprüefig isch vorübergehend nöd verfüegbar.
503 proofreading_unavailable De Feed für d’Textprüefig het nöd erstellt werde chönne. 
{
  "error": {
    "code": "proofreading_not_enabled",
    "message": "Proofreading is not enabled for this tracker."
  }
}