شناختوں کا API

ایک شناخت بنائیں

ایک نام، سرپرست ای میل، اور دائرہ کار کی وہ حد جس کی شناخت درخواست کر سکتی ہے کے ساتھ POST /v1/identities۔ جواب شناختی id، اس کی حیثیت، اور حل شدہ سرپرست واپس کرتا ہے۔

نام انسانوں کے لیے ہیں اور منفرد ہونے کی ضرورت نہیں؛ id مستحکم، مستند حوالہ ہے جو ہر جگہ استعمال ہوتا ہے۔

حاصل کریں اور فہرست بنائیں

GET /v1/identities/{id} ایک شناخت کو اس کے سرپرست، دائرہ کار کی حد، اور حیثیت کے ساتھ واپس کرتا ہے۔ GET /v1/identities انہیں کرسر پیجینیشن اور سرپرست اور حیثیت کے لیے فلٹرز کے ساتھ درج کرتا ہے۔

فہرست بنانا صرف پڑھنے کے لیے ہے اور پول کرنا محفوظ ہے؛ یہ فوری طور پر منسوخیوں اور سرپرست کی تبدیلیوں کی عکاسی کرتا ہے۔

سرپرست کو اپ ڈیٹ کریں

PATCH /v1/identities/{id} سرپرست بدلتا ہے یا دائرہ کار کی حد کو ایڈجسٹ کرتا ہے۔ پچھلی قدریں آڈٹ لاگ میں برقرار رکھی جاتی ہیں، اس لیے ریکارڈ ہمیشہ دکھاتا ہے کہ کسی بھی وقت کون جوابدہ تھا اور کیا اجازت تھی۔

منسوخ کریں

POST /v1/identities/{id}/revoke تمام منسلک نظاموں میں، بیک وقت، شناخت کے لیے ہر سند اور دائرہ کار کو غیر مؤثر بنا دیتا ہے۔ کال قابو مکمل ہونے پر واپس آتی ہے اور واقعہ آڈٹ لاگ میں درج ہو جاتا ہے۔