Endpoint REST API

GET /v1/responsibilities

Responsabilità attuali del team per un tracker, con indicazione della persona assegnata a ciascun ruolo visibile.

Richiesta

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

Utilizzare questo endpoint per mostrare chi è attualmente responsabile in uno strumento interno, senza esporre indirizzi email o dettagli sulle autorizzazioni.

Autenticazione

È necessaria una chiave API nell'intestazione Authorization: Authorization: Bearer nm_YOUR_KEY.

Parametri della query

Nome Tipo Obbligatorio Descrizione
site string obbligatorio ID del tracker. La chiave API deve avere accesso a questo tracker.

Esempio cURL

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

Esempio di risposta

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

Campi della risposta

Campo Tipo Descrizione
site string ID del tracker utilizzato per la richiesta.
updated_at string Data e ora nel fuso orario del tracker.
timezone string Fuso orario del tracker.
active boolean Indica se il monitoraggio delle responsabilità è attivo per questo tracker.
date string Data locale del tracker nel formato YYYY-MM-DD.
responsibilities[] array<object> Ruoli di responsabilità visibili.
responsibilities[].id integer ID del ruolo.
responsibilities[].name string Nome del ruolo.
responsibilities[].assignee object|null Utente assegnato oppure null se non è assegnato a nessuno.
responsibilities[].assignee.id integer ID dell'utente assegnato.
responsibilities[].assignee.name string Nome visualizzato dell'utente assegnato.
responsibilities[].assignee.initials string Iniziali dell'utente assegnato.
responsibilities[].assignee.avatar_url string URL dell'avatar oppure una stringa vuota se non è disponibile alcun avatar.
responsibilities[].assigned_at string|null Data e ora dell'assegnazione oppure null se non è assegnato a nessuno.

Aggiornamento e memorizzazione nella cache

Le risposte vengono memorizzate in una microcache per 10 secondi, in base all'account, al tracker e alla versione della cache delle assegnazioni, con una finestra di dati obsoleti di 60 secondi.

Errori

HTTP Codice Descrizione
400 site_required Manca il parametro site obbligatorio.
401 missing_token Manca l'intestazione Authorization.
401 invalid_token Il token non è valido oppure è stato revocato.
403 site_not_authorized La chiave API non ha accesso a questo tracker.
429 rate_limit_exceeded È stato superato il limite di richieste.
503 redis_unavailable Il backend realtime è temporaneamente non disponibile.
403 account_not_resolved Non è stato possibile determinare il contesto dell'account.
500 encoding_failed Non è stato possibile codificare la risposta. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}