GET /v1/responsibilities | API REST NowMetrix

Requête

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

Utilisez cet endpoint pour afficher la personne actuellement responsable dans un outil interne, sans exposer les adresses e-mail ni les détails des autorisations.

Authentification

Une clé API doit être fournie dans l’en-tête Authorization, sous la forme suivante : Authorization: Bearer nm_YOUR_KEY.

Paramètres de requête

Nom	Type	Obligatoire	Description
`site`	`string`	obligatoire	ID du tracker. La clé API doit avoir accès à ce tracker.

Exemple cURL

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

Exemple de réponse

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

Champs de réponse

Champ	Type	Description
`site`	`string`	ID du tracker utilisé pour la requête.
`updated_at`	`string`	Horodatage dans le fuseau horaire du tracker.
`timezone`	`string`	Fuseau horaire du tracker.
`active`	`boolean`	Indique si le suivi des responsabilités est actif pour ce tracker.
`date`	`string`	Date locale du tracker au format YYYY-MM-DD.
`responsibilities[]`	`array<object>`	Rôles de responsabilité visibles.
`responsibilities[].id`	`integer`	ID du rôle.
`responsibilities[].name`	`string`	Nom du rôle.
`responsibilities[].assignee`	`object\|null`	Utilisateur affecté, ou null si personne n’est affecté.
`responsibilities[].assignee.id`	`integer`	ID de l’utilisateur affecté.
`responsibilities[].assignee.name`	`string`	Nom d’affichage de l’utilisateur affecté.
`responsibilities[].assignee.initials`	`string`	Initiales de l’utilisateur affecté.
`responsibilities[].assignee.avatar_url`	`string`	URL de l’avatar, ou chaîne vide si aucun avatar n’est disponible.
`responsibilities[].assigned_at`	`string\|null`	Horodatage de l’affectation, ou null si personne n’est affecté.

Actualisation et mise en cache

Les réponses sont mises en microcache pendant 10 secondes par compte, tracker et version du cache des affectations, avec une période de conservation des données obsolètes de 60 secondes.

Erreurs

HTTP	Code	Description
400	`site_required`	Le paramètre site obligatoire est manquant.
401	`missing_token`	L’en-tête Authorization est manquant.
401	`invalid_token`	Le jeton n’est pas valide ou a été révoqué.
403	`site_not_authorized`	La clé API n’a pas accès à ce tracker.
429	`rate_limit_exceeded`	La limite de requêtes a été dépassée.
503	`redis_unavailable`	Le service de traitement en temps réel est temporairement indisponible.
403	`account_not_resolved`	Le contexte du compte n’a pas pu être déterminé.
500	`encoding_failed`	La réponse n’a pas pu être encodée.

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