Endpoint REST API

GET /v1/proofreading

Fino a 100 suggerimenti di revisione del testo attualmente visibili, ricavati dagli articoli controllati più di recente di un tracker.

Richiesta

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

Usare questo endpoint per recuperare i suggerimenti di revisione del testo più recenti disponibili per un tracker autorizzato. Sono esclusi i risultati contrassegnati come corretti o coperti da una regola di esclusione attiva.

Autenticazione

Richiede una chiave API nell'header Authorization: Authorization: Bearer nm_YOUR_KEY. La chiave deve consentire l'accesso al tracker ID richiesto.

Parametri della query

Nome Tipo Obbligatorio Descrizione
site string obbligatorio ID di monitoraggio NowMetrix. La chiave API deve consentire l'accesso a questo tracker. Non passare il dominio della testata.
limit integer facoltativo Numero massimo di suggerimenti. Il valore predefinito è 50, con un limite massimo di 100.

Esempio cURL

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

Esempio di risposta

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

Campi della risposta

Campo Tipo Descrizione
site string ID di monitoraggio usato per la richiesta.
updated_at string Data e ora in formato UTC in cui è stato generato il payload.
limit integer Limite effettivo dei risultati dopo la convalida e l'applicazione del limite massimo.
count integer Numero di suggerimenti visibili restituiti.
issues[] array<object> Suggerimenti visibili ordinati per checked_at in ordine decrescente.
issues[].id string Identificatore stabile e opaco di questa occorrenza del suggerimento.
issues[].checked_at string Data e ora in formato UTC del controllo dell'articolo che ha prodotto il suggerimento attuale.
issues[].article object Titolo e URL completo dell'articolo. Gli ID interni degli articoli non vengono esposti.
issues[].language object Codice della lingua rilevata e nome visualizzato.
issues[].category object Codice di categoria leggibile dalla macchina ed etichetta localizzata. Il codice consistency identifica contraddizioni interne all'articolo relative a nomi o dettagli fattuali quali numeri, date, orari, età, luoghi e ruoli.
issues[].location object Codice della sezione dell'articolo ed etichetta localizzata.
issues[].original string Testo originale individuato dalla revisione.
issues[].original_occurrence integer|null Numero, a partire da 1, dell'occorrenza del testo originale all'interno del contesto. Nei risultati legacy può essere null quando non è possibile individuare in modo univoco un testo ripetuto.
issues[].correction string Correzione suggerita.
issues[].context string Contesto dell'articolo normalizzato e con lunghezza limitata.
issues[].explanation string Spiegazione del suggerimento.
issues[].confidence string Livello di affidabilità accettato dalla pipeline di revisione del testo.

Aggiornamento e caching

Le risposte vengono memorizzate in microcache per 30 secondi, in base al tracker e al parametro limit. La risposta include X-NowMetrix-Microcache con valore HIT o MISS. checked_at indica il momento del controllo dell'articolo; l'endpoint non rappresenta uno storico di sola aggiunta delle prime rilevazioni.

Errori

HTTP Codice Descrizione
400 site_required Manca il parametro site obbligatorio.
401 missing_token Manca l'header Authorization.
401 invalid_token Il token non è valido o è stato revocato.
403 site_not_authorized La chiave API non consente l'accesso a questo tracker.
429 rate_limit_exceeded È stato superato il limite di richieste.
503 redis_unavailable Il backend realtime è temporaneamente non disponibile.
409 proofreading_not_enabled La revisione del testo non è abilitata per il tracker richiesto.
500 encoding_failed Non è stato possibile codificare la risposta.
503 database_unavailable Il database della revisione del testo è temporaneamente non disponibile.
503 proofreading_unavailable Non è stato possibile generare il feed della revisione del testo. 
{
  "error": {
    "code": "proofreading_not_enabled",
    "message": "Proofreading is not enabled for this tracker."
  }
}