API
Identities API
Buat, baca, sponsori, dan cabut identitas agen di direktori.
Membuat identitas
POST /v1/identities dengan nama, email sponsor, dan batas atas cakupan yang boleh diminta identitas. Respons mengembalikan identity id, statusnya, dan sponsor yang teresolusi.
Nama untuk manusia dan tidak perlu unik; id adalah referensi baku yang stabil digunakan di tempat lain.
Mengambil dan mendaftar
GET /v1/identities/{id} mengembalikan satu identitas dengan sponsor, batas atas cakupan, dan statusnya. GET /v1/identities mendaftar semuanya dengan paginasi cursor dan filter untuk sponsor dan status.
Pendaftaran bersifat baca-saja dan aman untuk di-poll; ini mencerminkan pencabutan dan perubahan sponsor secara langsung.
Memperbarui sponsor
PATCH /v1/identities/{id} mengubah sponsor atau menyesuaikan batas atas cakupan. Nilai sebelumnya tetap disimpan di log audit, sehingga catatan selalu menunjukkan siapa yang bertanggung jawab dan apa yang diizinkan pada titik waktu mana pun.
Mencabut
POST /v1/identities/{id}/revoke menonaktifkan setiap kredensial dan cakupan untuk identitas tersebut di seluruh sistem yang terhubung, secara sinkron. Panggilan ini kembali setelah penanganan selesai dan peristiwanya tercatat di log audit.