Entegrasyon

Adresler ve alan adları

Yazılım adresi nasıl doğar, kendi alan adını bağlayınca ne değişir, kodunda adresi nasıl kurmalısın.

Üç tür adres

TürÖrnekNe işe yarar
Çalışma alanı adresiacme.crm.blesyum.appÜrünün kanonik kapısı
Çıplak yazılım adresicrm.blesyum.appTanıtım sayfasına yönlendirir
Müşteri alan adıdestek.acme.comMüşterinin bağladığı adres

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

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

text
<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/&lt;modul&gt;/* — 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 yazılıma verirse, o yazılımı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:

Kodunda adres sabit yazma. https://acme.crm.blesyum.app yazan bir entegrasyon, müşteri kendi alan adını bağladığı gün yanlış adrese bakmaya başlar (çalışır ama kanonik değildir; SSO dönüşleri ve bağlantı üretimi bozulur).

Doğru kaynak:

bash
curl "https://accounts.blesyum.com/api/v1/modules" \
  -H "Authorization: Bearer <oturum-token>"
json
{ "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 yazılım, bir adres

Bir yazılıma 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:

text
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 yazılım lisanslandığında adres birkaç saniye içinde hazır olur; ayrı bir işlem yapman gerekmez.