Endpoint του REST API

GET /v1/responsibilities

Οι τρέχουσες αρμοδιότητες της ομάδας για ένα tracker, συμπεριλαμβανομένου του ατόμου που έχει αναλάβει κάθε εμφανιζόμενο ρόλο.

Αίτημα

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

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

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

Απαιτείται API key στην κεφαλίδα Authorization: Bearer nm_YOUR_KEY.

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

Όνομα Τύπος Απαιτείται Περιγραφή
site string απαιτείται ID του tracker. Το API key πρέπει να έχει πρόσβαση σε αυτόν τον tracker.

Παράδειγμα 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 του tracker που χρησιμοποιήθηκε για το αίτημα.
updated_at string Χρονική σήμανση στη ζώνη ώρας του tracker.
timezone string Ζώνη ώρας του tracker.
active boolean Υποδεικνύει αν η παρακολούθηση αρμοδιοτήτων είναι ενεργή για αυτόν τον tracker.
date string Τοπική ημερομηνία του tracker σε μορφή 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 του avatar ή κενή συμβολοσειρά αν δεν υπάρχει διαθέσιμο avatar.
responsibilities[].assigned_at string|null Χρονική σήμανση της ανάθεσης ή null αν δεν έχει ανατεθεί σε κανέναν.

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

Οι αποκρίσεις αποθηκεύονται σε μικροπροσωρινή μνήμη ανά λογαριασμό, tracker και έκδοση της cache αναθέσεων για 10 δευτερόλεπτα, ενώ παραμένουν διαθέσιμες ως παρωχημένες για 60 δευτερόλεπτα.

Σφάλματα

HTTP Κωδικός Περιγραφή
400 site_required Λείπει η απαιτούμενη παράμετρος site.
401 missing_token Λείπει η κεφαλίδα Authorization.
401 invalid_token Το token δεν είναι έγκυρο ή έχει ανακληθεί.
403 site_not_authorized Το API key δεν έχει πρόσβαση σε αυτόν τον tracker.
429 rate_limit_exceeded Έχει γίνει υπέρβαση του ορίου αιτημάτων.
503 redis_unavailable Η υποδομή realtime δεν είναι προσωρινά διαθέσιμη.
403 account_not_resolved Δεν ήταν δυνατή η επίλυση του πλαισίου του λογαριασμού.
500 encoding_failed Δεν ήταν δυνατή η κωδικοποίηση της απόκρισης.
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}