REST API-endpoint

GET /v1/responsibilities

De actuele verantwoordelijkheden binnen een team voor een tracker, inclusief de persoon die aan elke zichtbare rol is toegewezen.

Verzoek

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

Gebruik dit endpoint om in een interne tool te tonen wie momenteel verantwoordelijk is, zonder e-mailadressen of informatie over rechten bloot te geven.

Authenticatie

Hiervoor is een API-sleutel in de Authorization-header vereist: Authorization: Bearer nm_YOUR_KEY.

Queryparameters

Naam Type Vereist Beschrijving
site string vereist Tracker-ID. De API-sleutel moet toegang hebben tot deze tracker.

cURL-voorbeeld

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

Voorbeeldresponse

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

Responsevelden

Veld Type Beschrijving
site string Tracker-ID dat voor het verzoek is gebruikt.
updated_at string Tijdstip in de tijdzone van de tracker.
timezone string Tijdzone van de tracker.
active boolean Geeft aan of het bijhouden van verantwoordelijkheden voor deze tracker actief is.
date string Lokale datum van de tracker in de notatie YYYY-MM-DD.
responsibilities[] array<object> Zichtbare verantwoordelijkheidsrollen.
responsibilities[].id integer ID van de rol.
responsibilities[].name string Naam van de rol.
responsibilities[].assignee object|null Toegewezen gebruiker, of null als niemand is toegewezen.
responsibilities[].assignee.id integer ID van de toegewezen gebruiker.
responsibilities[].assignee.name string Weergavenaam van de toegewezen gebruiker.
responsibilities[].assignee.initials string Initialen van de toegewezen gebruiker.
responsibilities[].assignee.avatar_url string Avatar-URL, of een lege tekenreeks als er geen avatar beschikbaar is.
responsibilities[].assigned_at string|null Tijdstip van toewijzing, of null als niemand is toegewezen.

Actualiteit en caching

Responses worden per account, tracker en versie van de toewijzingscache 10 seconden in een microcache bewaard. Daarna kunnen gedurende 60 seconden nog verouderde gegevens worden teruggegeven.

Foutmeldingen

HTTP Code Beschrijving
400 site_required De vereiste siteparameter ontbreekt.
401 missing_token De Authorization-header ontbreekt.
401 invalid_token Het token is ongeldig of ingetrokken.
403 site_not_authorized De API-sleutel heeft geen toegang tot deze tracker.
429 rate_limit_exceeded De rate limit is overschreden.
503 redis_unavailable De realtimebackend is tijdelijk niet beschikbaar.
403 account_not_resolved De accountcontext kon niet worden vastgesteld.
500 encoding_failed De response kon niet worden gecodeerd. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}