Endpoint REST API

GET /v1/proofreading

Hingga 100 saran pemeriksaan teks yang terlihat saat ini dari artikel yang paling baru diperiksa pada satu tracker.

Permintaan

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

Gunakan endpoint ini untuk mengambil saran pemeriksaan teks terbaru yang tersedia untuk tracker yang memiliki akses. Hasil yang ditandai sebagai sudah diperbaiki atau tercakup dalam aturan pengabaian aktif tidak disertakan.

Autentikasi

Memerlukan kunci API pada header Authorization: Authorization: Bearer nm_YOUR_KEY. Kunci tersebut harus memiliki akses ke ID tracker yang diminta.

Parameter kueri

Nama Tipe Wajib Deskripsi
site string wajib ID pelacakan NowMetrix. Kunci API harus memiliki akses ke tracker ini. Jangan masukkan domain publikasi.
limit integer opsional Jumlah maksimum saran. Nilai bawaan adalah 50 dan dibatasi hingga 100.

Contoh cURL

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

Contoh respons

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

Field respons

Field Tipe Deskripsi
site string ID pelacakan yang digunakan untuk permintaan.
updated_at string Stempel waktu UTC saat payload dibuat.
limit integer Batas hasil efektif setelah validasi dan pembatasan.
count integer Jumlah saran yang terlihat dan dikembalikan.
issues[] array<object> Saran yang terlihat, diurutkan berdasarkan checked_at secara menurun.
issues[].id string Pengidentifikasi stabil dan buram untuk kemunculan saran ini.
issues[].checked_at string Stempel waktu UTC pemeriksaan artikel yang menghasilkan saran saat ini.
issues[].article object Judul artikel dan URL lengkap. ID artikel internal tidak ditampilkan.
issues[].language object Kode bahasa yang terdeteksi dan nama tampilannya.
issues[].category object Kode kategori yang dapat dibaca mesin dan label yang dilokalkan. Kode consistency menunjukkan kontradiksi internal dalam artikel pada nama atau detail faktual, seperti angka, tanggal, waktu, usia, lokasi, dan peran.
issues[].location object Kode bagian artikel dan label yang dilokalkan.
issues[].original string Teks asli yang diidentifikasi melalui pemeriksaan teks.
issues[].original_occurrence integer|null Kemunculan teks asli dalam konteks, dihitung mulai dari 1. Hasil lama dapat bernilai null jika teks berulang tidak dapat ditemukan secara jelas.
issues[].correction string Saran perbaikan.
issues[].context string Konteks artikel yang dinormalisasi dan dibatasi panjangnya.
issues[].explanation string Penjelasan untuk saran tersebut.
issues[].confidence string Tingkat keyakinan yang diterima oleh pipeline pemeriksaan teks.

Kebaruan dan caching

Respons disimpan dalam microcache selama 30 detik berdasarkan tracker dan limit. Respons menyertakan X-NowMetrix-Microcache dengan nilai HIT atau MISS. checked_at adalah waktu pemeriksaan artikel; endpoint ini bukan riwayat append-only dari deteksi pertama.

Error

HTTP Kode Deskripsi
400 site_required Parameter site yang wajib belum diisi.
401 missing_token Header Authorization tidak ada.
401 invalid_token Token tidak valid atau sudah dicabut.
403 site_not_authorized Kunci API tidak memiliki akses ke tracker ini.
429 rate_limit_exceeded Batas laju permintaan telah terlampaui.
503 redis_unavailable Backend realtime untuk sementara tidak tersedia.
409 proofreading_not_enabled Pemeriksaan teks tidak diaktifkan untuk tracker yang diminta.
500 encoding_failed Respons tidak dapat dienkode.
503 database_unavailable Database pemeriksaan teks untuk sementara tidak tersedia.
503 proofreading_unavailable Feed pemeriksaan teks tidak dapat dibuat. 
{
  "error": {
    "code": "proofreading_not_enabled",
    "message": "Proofreading is not enabled for this tracker."
  }
}