GET /v1/responsibilities | REST API NowMetrix

Požadavek

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

Tento endpoint použijte k zobrazení osoby, která je aktuálně odpovědná, v interním nástroji, aniž byste zpřístupnili e-mailové adresy nebo údaje o oprávněních.

Ověření

Vyžaduje klíč API v hlavičce Authorization ve formátu: Bearer nm_YOUR_KEY.

Parametry dotazu

Název	Typ	Povinné	Popis
`site`	`string`	povinné	ID trackeru. Klíč API musí mít k tomuto trackeru přístup.

Příklad cURL

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

Příklad odpovědi

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

Pole v odpovědi

Pole	Typ	Popis
`site`	`string`	ID trackeru použité v požadavku.
`updated_at`	`string`	Časové razítko v časovém pásmu trackeru.
`timezone`	`string`	Časové pásmo trackeru.
`active`	`boolean`	Určuje, zda je pro tento tracker aktivní sledování odpovědností.
`date`	`string`	Místní datum trackeru ve formátu YYYY-MM-DD.
`responsibilities[]`	`array<object>`	Role odpovědností, které se zobrazují.
`responsibilities[].id`	`integer`	ID role.
`responsibilities[].name`	`string`	Název role.
`responsibilities[].assignee`	`object\|null`	Přiřazený uživatel, nebo null, pokud není nikdo přiřazen.
`responsibilities[].assignee.id`	`integer`	ID přiřazeného uživatele.
`responsibilities[].assignee.name`	`string`	Zobrazované jméno přiřazeného uživatele.
`responsibilities[].assignee.initials`	`string`	Iniciály přiřazeného uživatele.
`responsibilities[].assignee.avatar_url`	`string`	URL avataru, nebo prázdný řetězec, pokud avatar není k dispozici.
`responsibilities[].assigned_at`	`string\|null`	Časové razítko přiřazení, nebo null, pokud není nikdo přiřazen.

Aktuálnost a cachování

Odpovědi se po dobu 10 sekund ukládají do mikrocache podle účtu, trackeru a verze cache přiřazení. Poté je po dobu 60 sekund možné vrátit zastaralá data.

Chyby

HTTP	Kód	Popis
400	`site_required`	Chybí povinný parametr site.
401	`missing_token`	Chybí hlavička Authorization.
401	`invalid_token`	Token je neplatný nebo odvolaný.
403	`site_not_authorized`	Klíč API nemá k tomuto trackeru přístup.
429	`rate_limit_exceeded`	Byl překročen limit požadavků.
503	`redis_unavailable`	Backend Realtime je dočasně nedostupný.
403	`account_not_resolved`	Kontext účtu se nepodařilo určit.
500	`encoding_failed`	Odpověď se nepodařilo zakódovat.

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