GET /v1/responsibilities | NowMetrix REST API-Dokumentation

Anfrage

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

Verwenden Sie diesen endpoint, um in einem internen Tool anzuzeigen, wer aktuell zuständig ist, ohne E-Mail-Adressen oder Berechtigungsdetails offenzulegen.

Authentifizierung

Erfordert einen API-Schlüssel im Authorization-Header: Authorization: Bearer nm_YOUR_KEY.

Query-Parameter

Name	Typ	Erforderlich	Beschreibung
`site`	`string`	erforderlich	Tracker-ID. Der API-Schlüssel muss Zugriff auf diesen Tracker haben.

cURL-Beispiel

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

Beispielantwort

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

Antwortfelder

Feld	Typ	Beschreibung
`site`	`string`	Für die Anfrage verwendete Tracker-ID.
`updated_at`	`string`	Zeitstempel in der Zeitzone des trackers.
`timezone`	`string`	Zeitzone des trackers.
`active`	`boolean`	Gibt an, ob die Erfassung von Zuständigkeiten für diesen Tracker aktiv ist.
`date`	`string`	Lokales Datum des trackers im Format YYYY-MM-DD.
`responsibilities[]`	`array<object>`	Sichtbare Zuständigkeitsrollen.
`responsibilities[].id`	`integer`	ID der Rolle.
`responsibilities[].name`	`string`	Name der Rolle.
`responsibilities[].assignee`	`object\|null`	Zugewiesene Person oder null, wenn niemand zugewiesen ist.
`responsibilities[].assignee.id`	`integer`	ID der zugewiesenen Person.
`responsibilities[].assignee.name`	`string`	Anzeigename der zugewiesenen Person.
`responsibilities[].assignee.initials`	`string`	Initialen der zugewiesenen Person.
`responsibilities[].assignee.avatar_url`	`string`	Avatar-URL oder eine leere Zeichenfolge, wenn kein Avatar verfügbar ist.
`responsibilities[].assigned_at`	`string\|null`	Zeitstempel der Zuweisung oder null, wenn niemand zugewiesen ist.

Aktualität und Caching

Antworten werden pro Konto, Tracker und Version des Zuweisungs-Caches 10 Sekunden lang im Microcache zwischengespeichert. Danach gilt ein 60 Sekunden langes Zeitfenster für veraltete Antworten.

Fehler

HTTP	Code	Beschreibung
400	`site_required`	Der erforderliche site-Parameter fehlt.
401	`missing_token`	Der Authorization-Header fehlt.
401	`invalid_token`	Der Token ist ungültig oder wurde widerrufen.
403	`site_not_authorized`	Der API-Schlüssel hat keinen Zugriff auf diesen Tracker.
429	`rate_limit_exceeded`	Das Rate-Limit wurde überschritten.
503	`redis_unavailable`	Das Realtime-Backend ist vorübergehend nicht verfügbar.
403	`account_not_resolved`	Der Kontokontext konnte nicht ermittelt werden.
500	`encoding_failed`	Die Antwort konnte nicht codiert werden.

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