Başlangıç

Hızlı başlangıç

Bir API anahtarı üret, kendi çalışma alanının adresine ilk isteğini at, yanıtın şeklini öğren.

Blesyum'un API'si tek bir kimlik modeli ve tek bir yanıt sözleşmesi üzerine kurulu. Hangi modülü çağırırsan çağır — CRM, ERP, E-Ticaret, B2B, Çağrı Merkezi, Mail, Müşavir, Reklam — kimlik doğrulama aynı, hata şekli aynı, sayfalama aynı.

1. Anahtarını üret

API anahtarları çekirdek panelde yaşar, modül panellerinde değil:

Panel → Geliştirici → API Anahtarları → Yeni anahtar

Anahtar üretirken kapsam (scope) seçersin. Kapsam, o anahtarın hangi uçları açacağını belirler; seçmediğin bir kapsamın ucu 403 döner. Kapsam listesi aboneliğindeki modüllere göre daralır — lisansın olmayan bir modülün kapsamı listede hiç görünmez.

Gizli anahtar bir kez gösterilir. Kaybedersen yenisini üretirsin; eskisini geri getirmenin yolu yoktur (biz de göremeyiz — veritabanında yalnız özeti durur).

Anahtar blsk_ önekiyle başlar.

2. Adresini bul

Her modülün, her çalışma alanı için kendi adresi vardır:

text
https://<calisma-alani>.<modul>.blesyum.app

Çalışma alanının kısa adını (slug) panelde Çalışma Alanı sayfasında görürsün. Kendi alan adını bağladıysan modülün adresi odur — platform adresi çalışmaya devam eder ama kanonik adres seninkidir.

ModülAdres
CRM&lt;slug&gt;.crm.blesyum.app
ERP&lt;slug&gt;.erp.blesyum.app
E-Ticaret&lt;slug&gt;.shop.blesyum.app
B2B&lt;slug&gt;.b2b.blesyum.app
Çağrı Merkezi&lt;slug&gt;.call.blesyum.app
Mail&lt;slug&gt;.bmail.blesyum.app
Müşavir&lt;slug&gt;.musavir.blesyum.app
Reklam&lt;slug&gt;.ads.blesyum.app

Slug'sız çıplak adres (crm.blesyum.app) bir giriş kapısı değildir; ürünün tanıtım sayfasına yönlendirir. Makine yolları (/api/...) orada da çalışır ama ürünün kanonik adresi çalışma alanına özel olandır.

3. İlk isteğin

bash
curl "https://acme.crm.blesyum.app/api/crm/public/v1/contacts?per_page=5" \
  -H "Authorization: Bearer blsk_..." \
  -H "Accept: application/json"

Yanıt:

json
{
  "type": "list",
  "data": [
    { "type": "contact", "id": "0193…", "name": "Ayşe Yılmaz", "email": "ayse@ornek.com" }
  ],
  "pages": { "type": "pages", "per_page": 5, "next": { "starting_after": "eyJ…" } }
}

Çalışma alanı anahtardan çözülür, adresten değil. Yani bir anahtar yalnız kendi çalışma alanını görür; yanlış host'a istek atsan bile başka bir kiracının verisine ulaşamazsın.

4. Bundan sonra

Bu sayfa işine yaradı mı?
Hâlâ takıldın mı? Destek al