REST API-endpoint

GET /v1/proofreading

Maximaal 100 momenteel zichtbare taalcontrolesuggesties uit de meest recent gecontroleerde artikelen van één tracker.

Aanvraag

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

Gebruik dit endpoint om de meest recente taalcontrolesuggesties voor een geautoriseerde tracker op te halen. Resultaten die als gecorrigeerd zijn gemarkeerd of onder een actieve negeerregel vallen, worden uitgesloten.

Authenticatie

Vereist een API-sleutel in de Authorization-header: Authorization: Bearer nm_YOUR_KEY. De sleutel moet toegang hebben tot de opgevraagde tracker-ID.

Queryparameters

Naam Type Verplicht Beschrijving
site string verplicht NowMetrix-tracking-ID. De API-sleutel moet toegang hebben tot deze tracker. Geef niet het publicatiedomein door.
limit integer optioneel Maximumaantal suggesties. Standaard 50, met een maximum van 100.

cURL-voorbeeld

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

Voorbeeldresponse

{
  "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"
    }
  ]
}

Responsevelden

Veld Type Beschrijving
site string Tracker-ID die voor de aanvraag is gebruikt.
updated_at string UTC-tijdstip waarop de payload is gegenereerd.
limit integer Effectieve resultaatlimiet na validatie en begrenzing.
count integer Aantal geretourneerde zichtbare suggesties.
issues[] array<object> Zichtbare suggesties, gesorteerd op checked_at in aflopende volgorde.
issues[].id string Ondoorzichtige, stabiele identifier voor deze instantie van de suggestie.
issues[].checked_at string UTC-tijdstip van de artikelcontrole die de huidige suggestie heeft opgeleverd.
issues[].article object Artikeltitel en volledige URL. Interne artikel-ID’s worden niet beschikbaar gesteld.
issues[].language object Vastgestelde taalcode en weergavenaam.
issues[].category object Machineleesbare categoriecode en gelokaliseerd label. De categoriecode consistency duidt op tegenstrijdigheden binnen het artikel in namen of feitelijke details, zoals getallen, datums, tijden, leeftijden, locaties en rollen.
issues[].location object Code en gelokaliseerd label van de artikelsectie.
issues[].original string Oorspronkelijke tekst die door de taalcontrole is geïdentificeerd.
issues[].original_occurrence integer|null Positie vanaf 1 van de oorspronkelijke tekst binnen de context. Bij oudere resultaten kan dit null zijn als herhaalde tekst niet eenduidig kan worden gelokaliseerd.
issues[].correction string Voorgestelde correctie.
issues[].context string Genormaliseerde en in lengte beperkte artikelcontext.
issues[].explanation string Toelichting bij de suggestie.
issues[].confidence string Betrouwbaarheidsniveau dat door de taalcontrolepipeline is geaccepteerd.

Actualiteit en caching

Responses worden per tracker en limiet 30 seconden gemicrocached. De response bevat X-NowMetrix-Microcache met HIT of MISS. checked_at is het tijdstip van de artikelcontrole; het endpoint biedt geen geschiedenis waarin alleen eerste detecties worden toegevoegd.

Fouten

HTTP Code Beschrijving
400 site_required De vereiste siteparameter ontbreekt.
401 missing_token De Authorization-header ontbreekt.
401 invalid_token Het token is ongeldig of ingetrokken.
403 site_not_authorized De API-sleutel heeft geen toegang tot deze tracker.
429 rate_limit_exceeded De rate limit is overschreden.
503 redis_unavailable De realtimebackend is tijdelijk niet beschikbaar.
409 proofreading_not_enabled Taalcontrole is niet ingeschakeld voor de opgevraagde tracker.
500 encoding_failed De response kon niet worden gecodeerd.
503 database_unavailable De taalcontroledatabase is tijdelijk niet beschikbaar.
503 proofreading_unavailable De taalcontrolefeed kon niet worden gegenereerd. 
{
  "error": {
    "code": "proofreading_not_enabled",
    "message": "Proofreading is not enabled for this tracker."
  }
}