modules — Blesyum Core API

GET/api/v1/modules

The active tenant's entitlements (modules + limits + status). Any member can

Oturum

read this (not 2FA-gated — needed for billing context, §8). Kiracının modülleri: lisans durumu + NEREDEN GİRİLECEĞİ. Panel bu ucu okumadan önce modül adreslerini iki ayrı sayfada elle kopyalanmış sabitlerde tutuyordu; müşteri "ERP'niz açıldı" cümlesini görüyor ama adresi hiçbir yerde bulamıyordu. Adresler artık tek kaynaktan (`blesyum_licensing::modules`) gelir. Yan etki (bilinçli): kiracıya özel adresler burada da GARANTİ EDİLİR. Aktivasyon anındaki kurulum herhangi bir sebeple kaçtıysa (eski kiracılar, geçici DB hatası) müşteri sayfayı açtığında kendiliğinden onarılır — kimsenin SQL çalıştırması gerekmez.

İstek

curl -X GET "https://api.blesyum.com/api/v1/modules" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/v1/modules/{key}

Tek modülün KÜNYESİ — panel iç sayfasının (`/modules/<key>`) tek veri kaynağı.

OturumYol parametresi: key

Liste ucu "hangi modül açık + adresi ne" der; iç sayfa bundan fazlasını sorar: ne zaman açıldı, planıma mı dahil, kimler kullanabiliyor, ne kadar hareket var, faturası ne, adresim sağlıklı mı. Toplama işi [`blesyum_licensing::module_detail`] içindedir (SQL crate'te kalır, handler ince). Yetki: kimlik + adres + lisans kaynağı HER üyeye açıktır — kendi modülünü görmek yetki istemez. Hassas bloklar çağıranın izinlerine göre doldurulur, yoksa `null` döner. Bilerek 403 DEĞİL: sayfanın geri kalanı yetkisiz üyeye de gösterilir, yoksa sıradan bir üye "modülüm bozuk" sanırdı.

İstek

curl -X GET "https://api.blesyum.com/api/v1/modules/<key>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

POST/api/v1/modules/{key}/launch

Modül için tek-tık giriş adresi üret. Oturum + üyelik + lisans şart.

OturumYol parametresi: key

İstek

curl -X POST "https://api.blesyum.com/api/v1/modules/<key>/launch" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}