İzinler API'si

Permissions API, Alaf Server'ın ekip ve erişim kontrol modelini çalıştırır: aktif org'un bir ekip olup olmadığını raporlar, grant edebileceğiniz kaynakları listeler, kişisel bir workspace'i bir ekip org'una yükseltir ve bir restricted üyeyi belirli projelere, server'lara veya diğer kaynaklara sınırlayan üye bazlı grant'leri ve davetiyeleri yönetir. dashboard'da bu, organizasyonun Ekip sekmesidir. Rollerin ve grant'lerin nasıl birleştiğini görmek için Kimlik Doğrulama ve Erişim bölümüne bakın.

Endpoint'ler

Bir ekip organizasyonu oluşturun

Yepyeni bir organizasyon oluşturur, onu bir ekip olarak işaretler ve çağrı yapanı sahibi olarak ayarlar. Kişisel workspace'ler kişisel kalır — bu, paylaşılan, çok üyeli bir org elde etmenin yoludur.

POST /api/permissions/create-team-org

curl -X POST https://your-host/api/permissions/create-team-org \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Platform"}'

Dönüş değeri 201 ve { data: { id, name, isTeam: true } } şeklindedir.

Grant edilebilir kaynakları listele

Grant modal'ı ve davet akışı için yan etkisi olmayan seçici payload'ı. Kaynak type'ını geçin; { id, label, meta? }[] geri alın. * wildcard'ı listelenmez — seçici onu kendi ekler.

GET /api/permissions/resources?type=project

curl "https://your-host/api/permissions/resources?type=server" \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN"

type=billing veya type=audit için tek giriş org genelindeki *'dır. type=github_repository için &owner=<login> ile bir hesaba daraltabilirsiniz.

Bir kaynağa grant ver

Tek bir grant tuple'ının idempotent upsert'i. Aynı (userId, resourceType, resourceId)'ı yeniden göndermek, permissions'ını yerinde değiştirir. Boş bir permissions dizisi grant'i iptal eder (Alaf Server sıfır izinli placeholder satırları tutmaz).

POST /api/permissions/grants

curl -X POST https://your-host/api/permissions/grants \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"userId":"user_123","resourceType":"project","resourceId":"proj_abc","permissions":["read","write"]}'

Dönüş değeri 201 ve { data: <grant> } şeklindedir veya permissions boş olduğunda { data: null, revoked: true } şeklindedir.

Bir üyenin grant setini değiştir

Üyenin tüm istenen grant setini gönderir; server mevcut olanla diff'ler — eklenen/değiştirilen tuple'ları upsert eder ve mevcut olmayanları siler. Bu, üye-grant'ler editörü için tek kaydetme yoludur. Sıfır izinli girişler düşürülür.

PUT /api/permissions/grants

grants'in her bir girişi bir Grant nesnesidir:

curl -X PUT https://your-host/api/permissions/grants \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "userId":"user_123",
    "grants":[
      {"resourceType":"project","resourceId":"proj_abc","permissions":["read","write"]},
      {"resourceType":"server","resourceId":"srv_1","permissions":["read"]}
    ]
  }'

Wildcard olmayan, satır tabanlı kaynakların aktif org'a ait olup olmadığı kontrol edilir; yabancı bir id 400 RESOURCE_NOT_IN_ORG ile reddedilir.

Grant'lerle bir üye davet et

Better Auth'un davetini sarmalar ve aynı çağrıda davetiyeye karşı bekleyen grant'leri saklar. Davetli kabul ettiğinde, kabul-davet sayfası bu bekleyen grant'leri gerçek grant'lere dönüştürmek için POST /invitations/:id/materialize çağrısını yapar.

POST /api/permissions/invite-with-grants

curl -X POST https://your-host/api/permissions/invite-with-grants \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email":"dev@acme.com",
    "role":"restricted",
    "grants":[{"resourceType":"project","resourceId":"proj_abc","permissions":["read","write"]}]
  }'

Dönüş değeri 201 ve { data: { id, email, role, pendingGrantCount } } şeklindedir.

Bir davetiyenin grant'lerini somutlaştır

Better Auth kabulü kaydettikten sonra kabul-davet sayfasından çağrılır. Davetiyenin bekleyen grant'lerini bulur, bunları artık katılmış olan kullanıcı için gerçek grant'ler olarak upsert eder ve bekleyen satırları temizler. Davetiyenin kendisi tarafından yetkilendirilir — çağrı yapanın e-postası davetiye ile eşleşmeli ve durumu accepted olmalıdır.

POST /api/permissions/invitations/:id/materialize

curl -X POST https://your-host/api/permissions/invitations/inv_123/materialize \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN"

Dönüş değeri { data: { materialized: <count> } } şeklindedir.

Görebileceğiniz hatalar