REST API एंडपॉइंट

GET /v1/proofreading

एक ट्रैकर के हाल ही में जाँचे गए लेखों से टेक्स्ट जाँच के अधिकतम 100 मौजूदा सुझाव।

अनुरोध

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

अधिकृत ट्रैकर के लिए टेक्स्ट जाँच के नवीनतम मौजूदा सुझाव पाने हेतु इस एंडपॉइंट का उपयोग करें। corrected के रूप में चिह्नित या सक्रिय अनदेखा करने का नियम के अंतर्गत आने वाले परिणाम शामिल नहीं किए जाते।

प्रमाणीकरण

Authorization हेडर में API कुंजी आवश्यक है: Authorization: Bearer nm_YOUR_KEY। इस कुंजी के पास अनुरोधित ट्रैकर ID का ऐक्सेस होना चाहिए।

क्वेरी पैरामीटर

नाम प्रकार आवश्यक विवरण
site string आवश्यक NowMetrix ट्रैकिंग ID। API कुंजी के पास इस ट्रैकर का ऐक्सेस होना चाहिए। प्रकाशन का डोमेन पास न करें।
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 अनुरोध में इस्तेमाल की गई ट्रैकिंग ID।
updated_at string पेलोड तैयार किए जाने का UTC टाइमस्टैंप।
limit integer सत्यापन और अधिकतम सीमा लागू करने के बाद की प्रभावी परिणाम सीमा।
count integer लौटाए गए दिखाई देने वाले सुझावों की संख्या।
issues[] array<object> दिखाई देने वाले सुझाव, checked_at के घटते क्रम में व्यवस्थित।
issues[].id string इस सुझाव की occurrence के लिए स्थिर, अपारदर्शी पहचानकर्ता।
issues[].checked_at string वर्तमान सुझाव तैयार करने वाली लेख-जाँच का UTC टाइमस्टैंप।
issues[].article object लेख का शीर्षक और पूरा URL। आंतरिक लेख IDs उजागर नहीं की जातीं।
issues[].language object पहचानी गई भाषा का कोड और दिखाया जाने वाला नाम।
issues[].category object मशीन-पठनीय श्रेणी कोड और स्थानीयकृत लेबल। consistency कोड लेख के भीतर नामों या संख्याओं, तारीखों, समय, उम्र, स्थानों और भूमिकाओं जैसे तथ्यात्मक विवरणों में विरोधाभास की पहचान करता है।
issues[].location object लेख के सेक्शन का कोड और स्थानीयकृत लेबल।
issues[].original string टेक्स्ट जाँच में पहचाना गया मूल टेक्स्ट।
issues[].original_occurrence integer|null कॉन्टेक्स्ट में original की 1 से शुरू होने वाला क्रमांक। दोहराए गए टेक्स्ट का स्थान स्पष्ट रूप से निर्धारित न किया जा सके, तो पुराने परिणामों में यह null हो सकता है।
issues[].correction string सुझाया गया सुधार।
issues[].context string मानकीकृत और लंबाई-सीमित लेख का कॉन्टेक्स्ट।
issues[].explanation string सुझाव का स्पष्टीकरण।
issues[].confidence string टेक्स्ट जाँच पाइपलाइन द्वारा स्वीकार किया गया भरोसा स्तर।

डेटा की ताज़गी और कैशिंग

हर ट्रैकर और limit के लिए रिस्पॉन्स को 30 सेकंड तक माइक्रोकैश किया जाता है। रिस्पॉन्स में X-NowMetrix-Microcache हेडर के साथ HIT या MISS शामिल होता है। checked_at लेख-जाँच का समय है; यह एंडपॉइंट पहली बार पता चलने का केवल जोड़ते जाने वाला इतिहास नहीं है।

त्रुटियाँ

HTTP कोड विवरण
400 site_required आवश्यक site पैरामीटर मौजूद नहीं है।
401 missing_token Authorization हेडर मौजूद नहीं है।
401 invalid_token टोकन अमान्य है या रद्द किया जा चुका है।
403 site_not_authorized API कुंजी के पास इस ट्रैकर का ऐक्सेस नहीं है।
429 rate_limit_exceeded रेट लिमिट पार हो गई है।
503 redis_unavailable रीयलटाइम बैकएंड अस्थायी रूप से उपलब्ध नहीं है।
409 proofreading_not_enabled अनुरोधित ट्रैकर के लिए टेक्स्ट जाँच सक्षम नहीं है।
500 encoding_failed रिस्पॉन्स को एनकोड नहीं किया जा सका।
503 database_unavailable टेक्स्ट जाँच का डेटाबेस अस्थायी रूप से उपलब्ध नहीं है।
503 proofreading_unavailable टेक्स्ट जाँच फ़ीड तैयार नहीं की जा सकी। 
{
  "error": {
    "code": "proofreading_not_enabled",
    "message": "Proofreading is not enabled for this tracker."
  }
}