Point de terminaison de l’API REST

GET /v1/proofreading

Jusqu’à 100 suggestions de correction actuellement visibles parmi les articles les plus récemment vérifiés pour un tracker.

Requête

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

Utilisez ce point de terminaison pour récupérer les suggestions de correction actuelles les plus récentes d’un tracker autorisé. Les résultats marqués comme corrigés ou couverts par une règle d’exclusion active sont exclus.

Authentification

Une clé API est requise dans l’en-tête Authorization, sous la forme suivante : Authorization: Bearer nm_YOUR_KEY. La clé doit donner accès à l’ID du tracker demandé.

Paramètres de requête

Nom Type Obligatoire Description
site string obligatoire ID de suivi NowMetrix. La clé API doit donner accès à ce tracker. Ne transmettez pas le domaine de la publication.
limit integer facultatif Nombre maximal de suggestions. La valeur par défaut est 50 et la valeur maximale est 100.

Exemple cURL

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

Exemple de réponse

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

Champs de réponse

Champ Type Description
site string ID de suivi utilisé pour la requête.
updated_at string Horodatage UTC de génération de la charge utile.
limit integer Limite effective de résultats après validation et plafonnement.
count integer Nombre de suggestions visibles renvoyées.
issues[] array<object> Suggestions visibles classées par ordre décroissant de checked_at.
issues[].id string Identifiant stable opaque de cette occurrence de suggestion.
issues[].checked_at string Horodatage UTC de la vérification de l’article ayant produit la suggestion actuelle.
issues[].article object Titre et URL complète de l’article. Les ID internes des articles ne sont pas exposés.
issues[].language object Code de langue détecté et nom affiché.
issues[].category object Code de catégorie lisible par machine et libellé localisé. La valeur consistency désigne les contradictions internes à l’article concernant des noms ou des informations factuelles telles que des nombres, des dates, des heures, des âges, des lieux et des fonctions.
issues[].location object Code de section de l’article et libellé localisé.
issues[].original string Texte original identifié par la correction.
issues[].original_occurrence integer|null Occurrence, à partir de 1, du texte original dans le contexte. Les anciens résultats peuvent contenir null lorsqu’un texte répété ne peut pas être localisé sans ambiguïté.
issues[].correction string Correction suggérée.
issues[].context string Contexte de l’article normalisé et limité en longueur.
issues[].explanation string Explication de la suggestion.
issues[].confidence string Niveau de confiance retenu par la chaîne de traitement de la correction.

Actualisation et mise en cache

Les réponses sont mises en microcache pendant 30 secondes pour chaque tracker et chaque valeur de limit. La réponse inclut X-NowMetrix-Microcache, avec la valeur HIT ou MISS. checked_at correspond à l’heure de vérification de l’article ; ce point de terminaison ne constitue pas un historique cumulatif des premières détections.

Erreurs

HTTP Code Description
400 site_required Le paramètre site obligatoire est manquant.
401 missing_token L’en-tête Authorization est manquant.
401 invalid_token Le token est invalide ou révoqué.
403 site_not_authorized La clé API ne permet pas d’accéder à ce tracker.
429 rate_limit_exceeded La limite de débit a été dépassée.
503 redis_unavailable Le service Redis est temporairement indisponible.
409 proofreading_not_enabled La correction de texte n’est pas activée pour le tracker demandé.
500 encoding_failed La réponse n’a pas pu être encodée.
503 database_unavailable La base de données de correction est temporairement indisponible.
503 proofreading_unavailable Le flux de correction n’a pas pu être généré. 
{
  "error": {
    "code": "proofreading_not_enabled",
    "message": "Proofreading is not enabled for this tracker."
  }
}