Endpoint του REST API

GET /v1/proofreading

Έως 100 ορατές προτάσεις γλωσσικού ελέγχου από τα πιο πρόσφατα ελεγμένα άρθρα ενός tracker.

Αίτημα

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

Χρησιμοποιήστε αυτό το endpoint για να ανακτήσετε τις πιο πρόσφατες προτάσεις γλωσσικού ελέγχου για έναν εξουσιοδοτημένο tracker. Εξαιρούνται τα αποτελέσματα που έχουν διορθωθεί ή καλύπτονται από ενεργό κανόνα εξαίρεσης.

Έλεγχος ταυτότητας

Απαιτείται κλειδί API στην κεφαλίδα Authorization: Authorization: Bearer nm_YOUR_KEY. Το κλειδί πρέπει να έχει πρόσβαση στο ζητούμενο tracker ID.

Παράμετροι ερωτήματος

Όνομα Τύπος Απαιτείται Περιγραφή
site string απαιτείται Tracking ID του NowMetrix. Το κλειδί API πρέπει να έχει πρόσβαση σε αυτόν τον tracker. Μην διαβιβάζετε το domain του μέσου.
limit integer προαιρετικό Μέγιστος αριθμός προτάσεων. Η προεπιλεγμένη τιμή είναι 50 και το ανώτατο όριο 100.

Παράδειγμα cURL

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

Παράδειγμα απόκρισης

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

Πεδία απόκρισης

Πεδίο Τύπος Περιγραφή
site string Το Tracking ID που χρησιμοποιήθηκε για το αίτημα.
updated_at string Χρονική σήμανση UTC για τη δημιουργία του payload.
limit integer Το ισχύον όριο αποτελεσμάτων μετά την επικύρωση και τον περιορισμό της τιμής.
count integer Ο αριθμός των ορατών προτάσεων που επιστράφηκαν.
issues[] array<object> Ορατές προτάσεις ταξινομημένες κατά φθίνουσα σειρά ως προς το checked_at.
issues[].id string Σταθερό, αδιαφανές αναγνωριστικό για τη συγκεκριμένη εμφάνιση της πρότασης.
issues[].checked_at string Χρονική σήμανση UTC του ελέγχου του άρθρου από τον οποίο προέκυψε η τρέχουσα πρόταση.
issues[].article object Τίτλος άρθρου και πλήρες URL. Τα εσωτερικά article ID δεν εκτίθενται.
issues[].language object Κωδικός εντοπισμένης γλώσσας και όνομα εμφάνισης.
issues[].category object Κωδικός κατηγορίας για μηχανική επεξεργασία και ετικέτα στη γλώσσα του χρήστη. Ο κωδικός consistency δηλώνει εσωτερικές αντιφάσεις του άρθρου σε ονόματα ή πραγματολογικά στοιχεία, όπως αριθμούς, ημερομηνίες, ώρες, ηλικίες, τοποθεσίες και ρόλους.
issues[].location object Κωδικός ενότητας άρθρου και ετικέτα στη γλώσσα του χρήστη.
issues[].original string Το αρχικό κείμενο που εντοπίστηκε κατά τον γλωσσικό έλεγχο.
issues[].original_occurrence integer|null Η εμφάνιση του αρχικού κειμένου μέσα στο context, με αρίθμηση από το 1. Σε παλαιότερα αποτελέσματα μπορεί να είναι null όταν το επαναλαμβανόμενο κείμενο δεν μπορεί να εντοπιστεί με σαφήνεια.
issues[].correction string Προτεινόμενη διόρθωση.
issues[].context string Κανονικοποιημένο απόσπασμα του άρθρου με περιορισμένο μήκος.
issues[].explanation string Επεξήγηση της πρότασης.
issues[].confidence string Επίπεδο βεβαιότητας που έγινε αποδεκτό από τη διαδικασία γλωσσικού ελέγχου.

Επικαιρότητα και προσωρινή αποθήκευση

Οι αποκρίσεις αποθηκεύονται σε microcache ανά tracker και limit για 30 δευτερόλεπτα. Η απόκριση περιλαμβάνει την κεφαλίδα X-NowMetrix-Microcache με τιμή HIT ή MISS. Το checked_at είναι η ώρα ελέγχου του άρθρου· το endpoint δεν αποτελεί ιστορικό μόνο προσθηκών των αρχικών εντοπισμών.

Σφάλματα

HTTP Κωδικός Περιγραφή
400 site_required Λείπει η απαιτούμενη παράμετρος site.
401 missing_token Λείπει η κεφαλίδα Authorization.
401 invalid_token Το token δεν είναι έγκυρο ή έχει ανακληθεί.
403 site_not_authorized Το κλειδί API δεν έχει πρόσβαση σε αυτόν τον tracker.
429 rate_limit_exceeded Έχει γίνει υπέρβαση του ορίου ρυθμού αιτημάτων.
503 redis_unavailable Το backend πραγματικού χρόνου δεν είναι προσωρινά διαθέσιμο.
409 proofreading_not_enabled Ο γλωσσικός έλεγχος δεν είναι ενεργοποιημένος για τον ζητούμενο tracker.
500 encoding_failed Δεν ήταν δυνατή η κωδικοποίηση της απόκρισης.
503 database_unavailable Η βάση δεδομένων γλωσσικού ελέγχου δεν είναι προσωρινά διαθέσιμη.
503 proofreading_unavailable Δεν ήταν δυνατή η δημιουργία της ροής γλωσσικού ελέγχου. 
{
  "error": {
    "code": "proofreading_not_enabled",
    "message": "Proofreading is not enabled for this tracker."
  }
}