Endpoint REST API

GET /v1/responsibilities

Aktualne zakresy odpowiedzialności zespołu dla trackera, w tym osoby przypisane do poszczególnych widocznych ról.

Żądanie

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

Endpoint umożliwia wyświetlenie w narzędziu wewnętrznym informacji o tym, kto aktualnie odpowiada za poszczególne zadania, bez ujawniania adresów e-mail ani szczegółów uprawnień.

Uwierzytelnianie

Wymaga podania klucza API w nagłówku Authorization w formacie Bearer nm_YOUR_KEY.

Parametry zapytania

Nazwa Typ Wymagany Opis
site string wymagany Identyfikator trackera. Klucz API musi mieć dostęp do tego trackera.

Przykład cURL

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

Przykładowa odpowiedź

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

Pola odpowiedzi

Pole Typ Opis
site string Identyfikator trackera użyty w żądaniu.
updated_at string Znacznik czasu w strefie czasowej trackera.
timezone string Strefa czasowa trackera.
active boolean Informacja, czy dla tego trackera aktywne jest śledzenie odpowiedzialności.
date string Lokalna data trackera w formacie YYYY-MM-DD.
responsibilities[] array<object> Widoczne role odpowiedzialności.
responsibilities[].id integer Identyfikator roli.
responsibilities[].name string Nazwa roli.
responsibilities[].assignee object|null Przypisany użytkownik albo null, jeśli nikt nie został przypisany.
responsibilities[].assignee.id integer Identyfikator przypisanego użytkownika.
responsibilities[].assignee.name string Nazwa wyświetlana przypisanego użytkownika.
responsibilities[].assignee.initials string Inicjały przypisanego użytkownika.
responsibilities[].assignee.avatar_url string URL awatara lub pusty ciąg, jeśli awatar jest niedostępny.
responsibilities[].assigned_at string|null Znacznik czasu przypisania lub null, jeśli nikt nie został przypisany.

Aktualność danych i buforowanie

Odpowiedzi są mikrobuforowane przez 10 sekund dla konta, trackera i wersji pamięci podręcznej przypisań, a przez kolejne 60 sekund mogą być zwracane nieaktualne dane.

Błędy

HTTP Kod Opis
400 site_required Brakuje wymaganego parametru site.
401 missing_token Brakuje nagłówka Authorization.
401 invalid_token Token jest nieprawidłowy lub został unieważniony.
403 site_not_authorized Klucz API nie ma dostępu do tego trackera.
429 rate_limit_exceeded Przekroczono limit żądań.
503 redis_unavailable Zaplecze czasu rzeczywistego jest tymczasowo niedostępne.
403 account_not_resolved Nie udało się ustalić kontekstu konta.
500 encoding_failed Nie udało się zakodować odpowiedzi. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}