Endpoint REST API

GET /v1/responsibilities

Tanggung jawab tim saat ini untuk sebuah tracker, termasuk pihak yang ditugaskan pada setiap peran yang terlihat.

Permintaan

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

Gunakan endpoint ini untuk menampilkan pihak yang saat ini bertanggung jawab dalam alat internal, tanpa mengekspos alamat email atau detail izin.

Autentikasi

Memerlukan API key di header Authorization: Bearer nm_YOUR_KEY.

Parameter query

Nama Tipe Wajib Deskripsi
site string wajib ID tracker. API key harus memiliki akses ke tracker ini.

Contoh cURL

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

Contoh respons

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

Kolom respons

Kolom Tipe Deskripsi
site string ID tracker yang digunakan dalam permintaan.
updated_at string Stempel waktu dalam zona waktu tracker.
timezone string Zona waktu tracker.
active boolean Menunjukkan apakah pelacakan tanggung jawab aktif untuk tracker ini.
date string Tanggal lokal tracker dalam format YYYY-MM-DD.
responsibilities[] array<object> Peran tanggung jawab yang terlihat.
responsibilities[].id integer ID peran.
responsibilities[].name string Nama peran.
responsibilities[].assignee object|null Pengguna yang ditugaskan, atau null jika tidak ada pengguna yang ditugaskan.
responsibilities[].assignee.id integer ID pengguna yang ditugaskan.
responsibilities[].assignee.name string Nama tampilan pengguna yang ditugaskan.
responsibilities[].assignee.initials string Inisial pengguna yang ditugaskan.
responsibilities[].assignee.avatar_url string URL avatar, atau string kosong jika avatar tidak tersedia.
responsibilities[].assigned_at string|null Stempel waktu penugasan, atau null jika tidak ada pengguna yang ditugaskan.

Kebaruan dan caching

Respons di-cache selama 10 detik berdasarkan akun, tracker, dan versi cache penugasan, dengan periode stale selama 60 detik.

Error

HTTP Kode Deskripsi
400 site_required Parameter site yang wajib belum diisi.
401 missing_token Header Authorization tidak ada.
401 invalid_token Token tidak valid atau sudah dicabut.
403 site_not_authorized API key tidak memiliki akses ke tracker ini.
429 rate_limit_exceeded Batas laju telah terlampaui.
503 redis_unavailable Backend realtime untuk sementara tidak tersedia.
403 account_not_resolved Konteks akun tidak dapat ditentukan.
500 encoding_failed Respons tidak dapat dienkode.
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}