Endpoint REST API

GET /v1/proofreading

Až 100 aktuálně viditelných návrhů kontroly textu z naposledy zkontrolovaných článků jednoho trackeru.

Požadavek

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

Tento endpoint slouží k získání nejnovějších aktuálních návrhů kontroly textu pro autorizovaný tracker. Výsledky označené jako opravené nebo zahrnuté v aktivním pravidle ignorování se vyloučí.

Ověření

Vyžaduje API key v hlavičce Authorization ve tvaru Authorization: Bearer nm_YOUR_KEY. Klíč musí mít přístup k požadovanému ID trackeru.

Parametry dotazu

Název Typ Povinné Popis
site string povinné Tracking ID v NowMetrix. API key musí mít k tomuto trackeru přístup. Nepředávejte doménu publikace.
limit integer volitelné Maximální počet návrhů. Výchozí hodnota je 50 a maximum je 100.

Příklad cURL

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

Příklad odpovědi

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

Pole odpovědi

Pole Typ Popis
site string Tracking ID použitý v požadavku.
updated_at string Časové razítko UTC označující okamžik vygenerování dat.
limit integer Efektivní limit výsledků po ověření a omezení maximální hodnotou.
count integer Počet vrácených viditelných návrhů.
issues[] array<object> Viditelné návrhy seřazené sestupně podle checked_at.
issues[].id string Neprůhledný stabilní identifikátor tohoto výskytu návrhu.
issues[].checked_at string Časové razítko UTC kontroly článku, při které vznikl aktuální návrh.
issues[].article object Název článku a úplná URL. Interní ID článků se nezpřístupňují.
issues[].language object Zjištěný kód jazyka a jeho zobrazovaný název.
issues[].category object Strojově čitelný kód kategorie a lokalizovaný popisek. Kód consistency označuje rozpory uvnitř článku v názvech nebo faktických údajích, například v číslech, datech, časech, věku, místech a rolích.
issues[].location object Kód části článku a lokalizovaný popisek.
issues[].original string Původní text identifikovaný kontrolou textu.
issues[].original_occurrence integer|null Pořadí výskytu původního textu v kontextu, počítané od 1. U starších výsledků může být hodnota null, pokud opakovaný text nelze jednoznačně najít.
issues[].correction string Navrhovaná oprava.
issues[].context string Normalizovaný kontext článku s omezenou délkou.
issues[].explanation string Vysvětlení návrhu.
issues[].confidence string Úroveň jistoty akceptovaná procesem kontroly textu.

Aktuálnost a cachování

Odpovědi se ukládají do mikrocache na 30 sekund, samostatně pro každý tracker a limit. Odpověď obsahuje X-NowMetrix-Microcache s hodnotou HIT nebo MISS. checked_at označuje čas kontroly článku; endpoint není historií prvních zjištění, do které se pouze přidávají nové záznamy.

Chyby

HTTP Kód Popis
400 site_required Chybí povinný parametr site.
401 missing_token Chybí hlavička Authorization.
401 invalid_token Token je neplatný nebo byl odvolán.
403 site_not_authorized API key nemá k tomuto trackeru přístup.
429 rate_limit_exceeded Byl překročen limit požadavků.
503 redis_unavailable Backend Realtime je dočasně nedostupný.
409 proofreading_not_enabled Kontrola textu není pro požadovaný tracker zapnutá.
500 encoding_failed Odpověď se nepodařilo zakódovat.
503 database_unavailable Databáze kontroly textu je dočasně nedostupná.
503 proofreading_unavailable Zdroj návrhů kontroly textu se nepodařilo vygenerovat. 
{
  "error": {
    "code": "proofreading_not_enabled",
    "message": "Proofreading is not enabled for this tracker."
  }
}