REST-API-endpoint

GET /v1/proofreading

Bis zu 100 aktuell sichtbare Textprüfungsvorschläge aus den zuletzt geprüften Artikeln eines Trackers.

Anfrage

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

Verwenden Sie diesen endpoint, um die neuesten verfügbaren Textprüfungsvorschläge für einen autorisierten Tracker abzurufen. Als korrigiert markierte Ergebnisse sowie Ergebnisse, die von einer aktiven Ignorierregel abgedeckt sind, werden ausgeschlossen.

Authentifizierung

Erfordert einen API-Schlüssel im Authorization-Header: Authorization: Bearer nm_YOUR_KEY. Der Schlüssel muss Zugriff auf die angeforderte Tracker-ID haben.

Abfrageparameter

Name Typ Erforderlich Beschreibung
site string erforderlich NowMetrix-Tracking-ID. Der API-Schlüssel muss Zugriff auf diesen Tracker haben. Übergeben Sie nicht die Domain der Publikation.
limit integer optional Maximale Anzahl an Vorschlägen. Standardmässig 50, begrenzt auf 100.

cURL-Beispiel

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

Beispielantwort

{
  "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 Beschreibung
site string Für die Anfrage verwendete Tracking-ID.
updated_at string UTC-Zeitstempel der Erstellung der Nutzdaten.
limit integer Effektives Ergebnislimit nach Validierung und Begrenzung.
count integer Anzahl der zurückgegebenen sichtbaren Vorschläge.
issues[] array<object> Sichtbare Vorschläge, absteigend nach checked_at sortiert.
issues[].id string Opake, stabile Kennung für dieses Vorkommen eines Vorschlags.
issues[].checked_at string UTC-Zeitstempel der Artikelprüfung, bei der der aktuelle Vorschlag erstellt wurde.
issues[].article object Artikeltitel und vollständige URL. Interne Artikel-IDs werden nicht offengelegt.
issues[].language object Erkannter Sprachcode und Anzeigename.
issues[].category object Maschinenlesbarer Kategoriecode und lokalisierte Bezeichnung. Der Code consistency kennzeichnet Widersprüche innerhalb eines Artikels bei Namen oder Fakten wie Zahlen, Daten, Uhrzeiten, Alter, Orten und Rollen.
issues[].location object Code und lokalisierte Bezeichnung des Artikelabschnitts.
issues[].original string Von der Textprüfung erkannter Originaltext.
issues[].original_occurrence integer|null Vorkommen des Originals innerhalb des Kontexts, beginnend bei 1. Bei älteren Ergebnissen kann der Wert null sein, wenn wiederholter Text nicht eindeutig lokalisiert werden kann.
issues[].correction string Vorgeschlagene Korrektur.
issues[].context string Normalisierter, in der Länge begrenzter Artikelkontext.
issues[].explanation string Erklärung zum Vorschlag.
issues[].confidence string Vom Textprüfungsprozess akzeptierte Vertrauensstufe.

Aktualität und Caching

Antworten werden pro Tracker und limit 30 Sekunden lang im Microcache gespeichert. Die Antwort enthält X-NowMetrix-Microcache mit HIT oder MISS. checked_at bezeichnet den Zeitpunkt der Artikelprüfung; der endpoint ist kein fortlaufendes Verlaufsprotokoll der erstmaligen Erkennungen.

Fehler

HTTP Code Beschreibung
400 site_required Der erforderliche site-Parameter fehlt.
401 missing_token Der Authorization-Header fehlt.
401 invalid_token Der Token ist ungültig oder wurde widerrufen.
403 site_not_authorized Der API-Schlüssel hat keinen Zugriff auf diesen Tracker.
429 rate_limit_exceeded Das Rate-Limit wurde überschritten.
503 redis_unavailable Das Realtime-Backend ist vorübergehend nicht verfügbar.
409 proofreading_not_enabled Die Textprüfung ist für den angeforderten Tracker nicht aktiviert.
500 encoding_failed Die Antwort konnte nicht codiert werden.
503 database_unavailable Die Textprüfungsdatenbank ist vorübergehend nicht verfügbar.
503 proofreading_unavailable Der Textprüfungs-Feed konnte nicht erstellt werden. 
{
  "error": {
    "code": "proofreading_not_enabled",
    "message": "Proofreading is not enabled for this tracker."
  }
}