Krajnja točka REST API-ja

GET /v1/proofreading

Do 100 trenutačno vidljivih prijedloga za provjeru teksta iz članaka jednog trackera koji su posljednji provjereni.

Zahtjev

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

Ovom krajnjom točkom dohvatite najnovije trenutačno dostupne prijedloge za provjeru teksta za autorizirani tracker. Rezultati označeni kao ispravljeni ili obuhvaćeni aktivnim pravilom zanemarivanja isključeni su.

Autentikacija

Potreban je API ključ u zaglavlju Authorization u obliku Authorization: Bearer nm_YOUR_KEY. Ključ mora imati pristup zatraženom ID-u trackera.

Parametri upita

Naziv Vrsta Obavezno Opis
site string obavezno NowMetrixov ID za praćenje. API ključ mora imati pristup ovom trackeru. Nemojte prosljeđivati domenu publikacije.
limit integer neobavezno Maksimalan broj prijedloga. Zadana je vrijednost 50, a najveća dopuštena vrijednost 100.

Primjer cURL-a

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

Primjer odgovora

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

Polja odgovora

Polje Vrsta Opis
site string ID za praćenje upotrijebljen u zahtjevu.
updated_at string Vremenska oznaka u UTC-u koja označava vrijeme generiranja sadržaja.
limit integer Stvarno ograničenje broja rezultata nakon provjere i primjene najveće dopuštene vrijednosti.
count integer Broj vraćenih vidljivih prijedloga.
issues[] array<object> Vidljivi prijedlozi poredani silazno prema polju checked_at.
issues[].id string Stabilni neprozirni identifikator ove pojave prijedloga.
issues[].checked_at string Vremenska oznaka u UTC-u provjere članka pri kojoj je generiran trenutačni prijedlog.
issues[].article object Naslov članka i potpuni URL. Interni ID-ovi članaka nisu dostupni.
issues[].language object Otkriveni kod jezika i naziv za prikaz.
issues[].category object Strojno čitljiv kod kategorije i lokalizirana oznaka. Kod consistency označava proturječja unutar članka u nazivima ili činjeničnim detaljima kao što su brojevi, datumi, vremena, dobi, lokacije i uloge.
issues[].location object Kod odjeljka članka i lokalizirana oznaka.
issues[].original string Izvorni tekst koji je utvrđen provjerom teksta.
issues[].original_occurrence integer|null Pojava izvornog teksta unutar konteksta, pri čemu brojanje počinje od 1. Naslijeđeni rezultati mogu sadržavati vrijednost null kada ponovljeni tekst nije moguće nedvosmisleno pronaći.
issues[].correction string Predloženi ispravak.
issues[].context string Normalizirani kontekst članka ograničene duljine.
issues[].explanation string Objašnjenje prijedloga.
issues[].confidence string Razina pouzdanosti prihvaćena u sustavu za provjeru teksta.

Aktualnost i predmemoriranje

Odgovori se mikrospremaju po trackeru i ograničenju broja rezultata tijekom 30 sekundi. Odgovor uključuje zaglavlje X-NowMetrix-Microcache s vrijednošću HIT ili MISS. checked_at označava vrijeme provjere članka; krajnja točka nije povijest prvih otkrivanja koja se samo dopunjuje.

Pogreške

HTTP Kod Opis
400 site_required Nedostaje obavezni parametar site.
401 missing_token Nedostaje zaglavlje Authorization.
401 invalid_token Token nije valjan ili je opozvan.
403 site_not_authorized API ključ nema pristup ovom trackeru.
429 rate_limit_exceeded Prekoračeno je ograničenje broja zahtjeva.
503 redis_unavailable Realtimeska pozadinska usluga trenutačno nije dostupna.
409 proofreading_not_enabled Provjera teksta nije omogućena za zatraženi tracker.
500 encoding_failed Odgovor nije moguće kodirati.
503 database_unavailable Baza podataka za provjeru teksta trenutačno nije dostupna.
503 proofreading_unavailable Nije moguće generirati izvor podataka za provjeru teksta. 
{
  "error": {
    "code": "proofreading_not_enabled",
    "message": "Proofreading is not enabled for this tracker."
  }
}