API anahtarları ve erişim token’ları

Bir API anahtarı, programlarının LinkHarbor API’sine girdiği yoldur. Bir kişiye değil bir çalışma alanına aittir ve kapsamlarla tam olarak izin verdiğin şeyleri yapabilir. Asıl çağrılar için anahtarı kısa ömürlü bir erişim token’ıyla değiştirirsin.

#API anahtarlarını kim oluşturabilir?

• Çalışma alanının sahipleri ve yöneticileri – editörler ve görüntüleyenler “Callback ve API” altında yalnızca “Bağlı uygulamalar” kartını görür
• Creator Pro’dan itibaren; Creator Free’de kartta “API anahtarları Creator Pro’dan itibaren kullanılabilir.” yazar
• Aynı anda etkin: Creator Pro’da en fazla 5, Creator Agency’de en fazla 20, Enterprise’da en fazla 50 anahtar

Limite ulaşıldığında bir anahtar oluşturmak 409 limit_reached ile başarısız olur. Önce artık ihtiyacın olmayan bir anahtarı sil.

#API anahtarı oluştur

1. Gezinmede “Callback ve API”yi aç
2. “API anahtarları” kartında “+ Yeni anahtar oluştur”a tıkla
3. “İsim (isteğe bağlı)” altında anahtarı daha sonra tanıyacağın bir ad gir, örneğin “CI/CD hattı” veya “Mağaza senkronizasyonu”
4. “Kapsamlar” altında her alan için “Okuma” veya “Yazma”yı seç
5. “Anahtar oluştur”a tıkla
6. “Anahtar gizli değeri (özel)”ni hemen kopyala ve güvenli bir yerde sakla
7. Pencereyi kapat – anahtar kimliğini istediğin zaman listede bulabilirsin

“İsim (isteğe bağlı)”

En fazla 64 karakter. Ad olmadan anahtar listede “API anahtarı #ID” olarak görünür.

“Kapsamlar”

En az biri zorunludur. “Yazma” aynı alan için “Okuma”yı otomatik olarak içerir. İstatistikler ve destekçi ödemeleri yalnızca okunur, çalışma alanı şablonları yalnızca yazılır. Tüm kapsamlar Ayrıntılı kapsamlar bölümünde açıklanıyor.

“Anahtar gizli değeri (özel)”

lt_ ile başlar ve tam olarak bir kez gösterilir (“⚠️ Yalnızca bir kez görünür — şimdi kopyala!”). LinkHarbor yalnızca bir hash’ini saklar ve sana daha sonra yeniden gösteremez.

“Anahtar kimliği:”

Rakamlardan ve A–F büyük harflerinden oluşan 16 karakter, örneğin 6F668EA6598B0692. Gizli değildir ve listede bir kopyalama düğmesiyle görünür.

#Anahtar listesi

Her etkin anahtar adını, “Aktif” durumunu, anahtar kimliğini, kapsamlarını, “Oluşturulma:” ve “Son kullanım:” ya da “Henüz kullanılmadı” bilgisini gösterir. Son kullanım zamanı, anahtarla yapılan her çağrıda en fazla dakikada bir güncellenir. “↺ Yenile” listeyi yeniden yükler.

#Anahtarı bir erişim token’ıyla değiştir

curl -X POST https://dock.at-harbor.com/v1/token \
  -H "Content-Type: application/json" \
  -d '{"key_id":"6F668EA6598B0692","key_secret":"lt_…"}'

{ "token": "eyJhbGciOiJIUzI1NiIs…", "expires_in": 900 }

token

Erişim token’ı. Onu her istekte Authorization: Bearer <token> olarak gönderirsin.

expires_in

Saniye cinsinden geçerlilik: 900, yani 15 dakika. Yenileme token’ı yoktur – süresi dolduğunda anahtar kimliği ve gizli değerle yeni bir token alman yeterli.

Token çalışma alanını temsil eder ve tam olarak anahtarın kapsamlarını taşır. Bir kişi gibi bir rolü yoktur: panelin sahiplere ve yöneticilere ayırdığı uç noktalar (üyeler, faturalama, alan adı yönetimi, webhook’lar, çalışma alanı ayarları) API anahtarlarından gelen token’lara her zaman reddedilir. İstisnalar, uygun kapsamla çalışan kısa bağlantılar ve çalışma alanı şablonları ile read:workspaces ile callback gizli anahtarlarını (düz metin gizli değer olmadan) okumaktır.

#Hatalı denemeler ve kilitleme

api_key_locked ile kalan süre details.retry_after_sec içindedir. Başarılı bir değişim sayacı sıfırlar.

#Bir anahtarı sil ve değiştir

1. Anahtarın yanındaki “Sil”e tıkla
2. Onaylamak için DELETE yaz
3. “Kalıcı olarak sil”e tıkla

Anahtar hemen çalışmayı bırakır – zaten verilmiş erişim token’ları da o andan itibaren çalışmaz ve 401 invalid_token alır. Bir yenileme (rotate) düğmesi yoktur. Anahtar değiştirmek için yeni bir anahtar oluştur, programını ona taşı ve ardından eskisini sil.

#Plan düştüğünde

Çalışma alanı Creator Free’ye geçerse tüm API anahtarları iptal edilir. Daha az anahtarlı bir plana geçerse en yeniler korunur ve geri kalanlar iptal edilir. İptal edilen anahtarlar sonraki bir yükseltmede geri gelmez – o zaman yenilerini oluşturursun. Sahipler devre dışı bırakılan özellikleri listeleyen bir e-posta alır. Daha fazlası İptal etme ve plan düşürme bölümünde.

#Güvende tutma

• Gizli değeri yalnızca bir gizli bilgi yöneticisinde veya ortam değişkenlerinde tut, asla kaynak kodda veya bir Git deposunda değil
• Onu asla tarayıcıda veya kullanıcının cihazındaki bir uygulamada çalışan kodda kullanma
• Her uygulama için mümkün olduğunca az kapsamla ayrı bir anahtar oluştur
• Artık ihtiyacın olmayan anahtarları hemen sil
• Bir sızıntıdan şüpheleniyorsan: anahtarı sil ve yenisini oluştur