B2B Worker Docs

Auth & API Keys

CRM entegrasyonu API key kullanır. Panel (UI) JWT kullanır.

CRM: API key

Authorization: Bearer b2b_<your_api_key>
  • Anahtarlar panelde API Keys sayfasından oluşturulur.
  • Plaintext key yalnızca oluşturma anında bir kez gösterilir.
  • Prefix b2b_ ile başlar; sunucu hash saklar.

Scope’lar

ScopeKullanım
events:writeEvent gönderme
events:readEvent okuma / katalog
partners:readPartner listesi
partners:writePartner oluşturma/güncelleme
executions:readÇalıştırma okuma
webhooks:manageWebhook abonelik / delivery

Liste: GET /api/v1/api-keys/scopes/

Rate limit

API key istekleri: 120/dakika (throttle api_key).

Panel: JWT

Authorization: Bearer <access_jwt>
  • POST /api/v1/auth/login/ → access + refresh
  • API key yönetimi (oluşturma/revoke) yalnızca JWT ile; API key kendini yönetemez (403).

Endpoints

MethodPathAuthAçıklama
GET/api/v1/api-keys/JWTListe
POST/api/v1/api-keys/JWTOluştur (name, scopes)
POST/api/v1/api-keys/{id}/revoke/JWTİptal
GET/api/v1/api-keys/scopes/JWT/APIScope listesi

Örnek oluşturma (panel token)

curl -X POST https://app.b2bworker.com/api/v1/api-keys/ \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{"name":"crm-prod","scopes":["events:write","events:read","executions:read","webhooks:manage"]}'

UI

Panel: /api-keys

İlgili: Eventler, Webhooks