Adresler ve alan adları

#Üç tür adres

#Çalışma alanı adresi kendiliğinden doğar

Bir modül lisanslandığı anda o modülün çalışma alanına özel adresi kurulur. Kimseden istemek, destek talebi açmak ya da beklemek gerekmez.

<slug>.<modul>.blesyum.app

#Çıplak adres bir giriş kapısı DEĞİLDİR

crm.blesyum.app adresine tarayıcıyla gelen ziyaretçi ürünün tanıtım sayfasına 302 ile yönlendirilir. Ama makine yolları orada da çalışır:

• /api/<modul>/* — webhook girişleri, OAuth callback'leri
• /api/v1/* — çekirdek
• /.well-known/* — alan adı sahiplik doğrulaması

Bu ayrım kasıtlıdır: bir OAuth callback adresini çıplak host'a kaydettiysen o adres çalışmaya devam eder.

#Müşteri kendi alan adını bağlarsa

Müşteri bir alan adı bağlayıp hedefini bir modüle verirse, o modülün adresi odur. Platform adresi çalışmaya devam eder ama tarayıcı istekleri müşterinin adresine 302 ile taşınır.

Bunun entegrasyon için tek anlamı var:

Doğru kaynak:

curl "https://accounts.blesyum.com/api/v1/modules" \
  -H "Authorization: Bearer <oturum-token>"

{ "data": [
    { "key": "crm", "label": "CRM", "licensed": true,
      "url": "https://destek.acme.com",
      "openapi_url": "https://destek.acme.com/api/crm/public/v1/openapi.json" }
] }

url alanı etkin adrestir: müşteri kendi alan adını bağladıysa onu, yoksa platform adresini taşır.

#Bir modül, bir adres

Bir modüle aynı anda yalnız bir müşteri alan adı bağlanabilir. Bu, "hangisi kanonik" sorusunu ortadan kaldırır — bağlantılar, e-postalar, SSO dönüşleri ve arama motoru tek bir adres görür.

#E-Ticaret'in istisnası

E-Ticaret'te müşterinin adresi vitrini açar; yönetim paneli ayrı bir origin'dedir:

acme.shop.blesyum.app          → vitrin (müşteriye görünen mağaza)
acme--panel.shop.blesyum.app   → yönetim paneli

API yolları (/api/shop/v1/...) her ikisinde de çalışır.

#TLS

Her çalışma alanı adresi kendi sertifikasını talep anında alır. Yeni bir modül lisanslandığında adres birkaç saniye içinde hazır olur; ayrı bir işlem yapman gerekmez.