Endpoint de la API REST

GET /v1/responsibilities

Responsabilidades actuales del equipo para un tracker, incluida la persona asignada a cada rol visible.

Solicitud

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

Utilice este endpoint para mostrar quién es actualmente responsable en una herramienta interna, sin exponer direcciones de correo electrónico ni detalles de permisos.

Autenticación

Requiere una clave de API en la cabecera Authorization, con el formato: Authorization: Bearer nm_YOUR_KEY.

Parámetros de consulta

Nombre Tipo Obligatorio Descripción
site string obligatorio Identificador del tracker. La clave de API debe tener acceso a este tracker.

Ejemplo cURL

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

Ejemplo de respuesta

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

Campos de la respuesta

Campo Tipo Descripción
site string Identificador del tracker utilizado para la solicitud.
updated_at string Marca de tiempo en la zona horaria del tracker.
timezone string Zona horaria del tracker.
active boolean Indica si el seguimiento de responsabilidades está activo para este tracker.
date string Fecha local del tracker en formato YYYY-MM-DD.
responsibilities[] array<object> Roles de responsabilidad visibles.
responsibilities[].id integer Identificador del rol.
responsibilities[].name string Nombre del rol.
responsibilities[].assignee object|null Usuario asignado o null si no hay nadie asignado.
responsibilities[].assignee.id integer Identificador del usuario asignado.
responsibilities[].assignee.name string Nombre visible del usuario asignado.
responsibilities[].assignee.initials string Iniciales del usuario asignado.
responsibilities[].assignee.avatar_url string URL del avatar o una cadena vacía si no hay ningún avatar disponible.
responsibilities[].assigned_at string|null Marca de tiempo de la asignación o null si no hay nadie asignado.

Actualización y caché

Las respuestas se almacenan en una microcaché durante 10 segundos por cuenta, tracker y versión de la caché de asignaciones, con un periodo de tolerancia para datos obsoletos de 60 segundos.

Errores

HTTP Código Descripción
400 site_required Falta el parámetro site obligatorio.
401 missing_token Falta la cabecera Authorization.
401 invalid_token El token no es válido o se ha revocado.
403 site_not_authorized La clave de API no tiene acceso a este tracker.
429 rate_limit_exceeded Se ha superado el límite de solicitudes.
503 redis_unavailable El backend en tiempo real no está disponible temporalmente.
403 account_not_resolved No se ha podido resolver el contexto de la cuenta.
500 encoding_failed No se ha podido codificar la respuesta. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}