GET /v1/responsibilities | NowMetrix REST API दस्तावेज़

रिक्वेस्ट

GET https://api.nowmetrix.com/v1/responsibilities?site=TRACKER_ID

इस एंडपॉइंट का उपयोग किसी आंतरिक टूल में यह दिखाने के लिए करें कि अभी किसकी ज़िम्मेदारी है, और ईमेल पते या अनुमति संबंधी विवरण उजागर न हों।

ऑथेंटिकेशन

Authorization हेडर में API कुंजी आवश्यक है: Authorization: Bearer nm_YOUR_KEY.

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

नाम	प्रकार	आवश्यक	विवरण
`site`	`string`	आवश्यक	ट्रैकर ID। API कुंजी को इस ट्रैकर तक पहुँच प्राप्त होनी चाहिए।

cURL उदाहरण

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

रिस्पॉन्स का उदाहरण

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T14:24:30+02:00",
  "timezone": "Europe/Zurich",
  "active": true,
  "date": "2026-06-26",
  "responsibilities": [
    {
      "id": 12,
      "name": "Homepage",
      "assignee": {
        "id": 935,
        "name": "Maya Keller",
        "initials": "MK",
        "avatar_url": "https://imagedelivery.net/example/avatar/public"
      },
      "assigned_at": "2026-06-26 09:14:22"
    },
    {
      "id": 13,
      "name": "Video",
      "assignee": null,
      "assigned_at": null
    }
  ]
}

रिस्पॉन्स फ़ील्ड

फ़ील्ड	प्रकार	विवरण
`site`	`string`	रिक्वेस्ट में इस्तेमाल किया गया ट्रैकर ID।
`updated_at`	`string`	ट्रैकर के टाइमज़ोन के अनुसार टाइमस्टैम्प।
`timezone`	`string`	ट्रैकर का टाइमज़ोन।
`active`	`boolean`	बताता है कि इस ट्रैकर के लिए ज़िम्मेदारी ट्रैकिंग सक्रिय है या नहीं।
`date`	`string`	YYYY-MM-DD फ़ॉर्मैट में ट्रैकर की स्थानीय तारीख।
`responsibilities[]`	`array<object>`	दिखाई देने वाली ज़िम्मेदारी की भूमिकाएँ।
`responsibilities[].id`	`integer`	भूमिका की ID।
`responsibilities[].name`	`string`	भूमिका का नाम।
`responsibilities[].assignee`	`object\|null`	नियुक्त उपयोगकर्ता, या किसी के नियुक्त न होने पर null।
`responsibilities[].assignee.id`	`integer`	नियुक्त उपयोगकर्ता की ID।
`responsibilities[].assignee.name`	`string`	नियुक्त उपयोगकर्ता का डिस्प्ले नाम।
`responsibilities[].assignee.initials`	`string`	नियुक्त उपयोगकर्ता के नाम के शुरुआती अक्षर।
`responsibilities[].assignee.avatar_url`	`string`	अवतार का URL, या अवतार उपलब्ध न होने पर खाली string।
`responsibilities[].assigned_at`	`string\|null`	नियुक्त किए जाने का टाइमस्टैम्प, या किसी के नियुक्त न होने पर null।

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

रिस्पॉन्स को अकाउंट, ट्रैकर और असाइनमेंट कैश के संस्करण के आधार पर 10 सेकंड तक माइक्रोकैश किया जाता है और उसके बाद 60 सेकंड तक पुराना कैश्ड डेटा दिया जा सकता है।

त्रुटियाँ

HTTP	कोड	विवरण
400	`site_required`	आवश्यक site पैरामीटर मौजूद नहीं है।
401	`missing_token`	Authorization हेडर मौजूद नहीं है।
401	`invalid_token`	टोकन अमान्य है या रद्द किया जा चुका है।
403	`site_not_authorized`	API कुंजी को इस ट्रैकर तक पहुँच प्राप्त नहीं है।
429	`rate_limit_exceeded`	अनुरोधों की निर्धारित सीमा पार हो गई है।
503	`redis_unavailable`	रीयलटाइम बैकएंड अस्थायी रूप से उपलब्ध नहीं है।
403	`account_not_resolved`	अकाउंट संदर्भ का पता नहीं लगाया जा सका।
500	`encoding_failed`	रिस्पॉन्स को एन्कोड नहीं किया जा सका।

{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}