Hızlı başlangıç

İlk live anahtarınızı oluşturun ve beş dakikada ilk kısa linki API ile üretin.

1 dk okuma 3 bölüm

Beklio Link Developer API, Link kaynaklarınızı gerçek (live) verilerle yönetmenizi sağlar. Tüm public istekler gateway üzerinden https://api.beklio.com/api/v1/links altında yapılır.

1. Anahtar oluşturun#

Developer konsolunda oturum açın ve yalnızca ihtiyacınız olan scope'larla bir bk_live_… anahtarı oluşturun. Secret yalnızca oluşturma yanıtında bir kez gösterilir; hemen bir secret manager'a kaydedin.

2. İlk isteği gönderin#

create-link.sh

curl -X POST "https://api.beklio.com/api/v1/links" \
  -H "Authorization: Bearer bk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-2026-001" \
  -d '{
    "kind": "DIRECT",
    "domainId": "bekl.io",
    "url": "https://example.com/launch",
    "slug": "launch"
  }'

Yanıtlar gateway tarafından { data, meta? } zarfına normalize edilir ve her yanıtta X-Request-Id başlığı bulunur.

3. Sonraki adımlar#

Kimlik doğrulama ve scope'lar — hangi işlem hangi yetkiyi ister.
Link oluşturma — kısa biçim ile tam route graph arasındaki fark.
Hatalar ve limitler — 401/403/409/429/503 davranışı.

Yeni entegrasyonlarda her mutation için benzersiz bir Idempotency-Key gönderin; ağ hatasında aynı anahtarla güvenle tekrar deneyebilirsiniz.

Bir şey eksik veya hatalı mı? Destek ekibine yazın; yanıttaki X-Request-Id değerini eklemek çözümü hızlandırır.