İçeriğe geç

Başlarken

Kimlik doğrulama

API anahtarları, yetkiler, klasörle sınırlama, anahtarı güvende tutma ve iptal etme.

Her istek Authorization başlığında bir anahtar taşır:

Authorization: Bearer kvd_8Hq2…

Anahtar kvd_ ile başlar, ardından 43 karakter gelir. Kivilio anahtarın kendisini saklamaz, yalnızca özetini tutar; bu yüzden kaybedersen yenisini oluşturman gerekir.

Yetkiler

YetkiNe yapar
drive:readListeleme, arama, tek öğe, indirme, önizleme, kullanım
drive:writeYükleme, klasör, yeniden adlandırma, taşıma, çöp, kalıcı silme
drive:shareKişiye paylaşım, süreli bağlantı, herkese açık yapma

Anahtara, kendi hesabında olmayan bir yetki verilemez. Yönetim yetkileri hiçbir anahtara verilmez. Yetkisi olmayan bir işlem 403 forbidden döner.

Klasörle sınırlama

Anahtarı oluştururken bir klasör seçersen anahtar yalnızca o klasörde ve altında çalışır:

  • Klasör dışındaki her öğe 404 döner; varlığı bile görünmez.
  • parentId vermeden yükleme ve klasör açma, anahtarın klasörüne gider.
  • GET /nodes (parentId'siz) anahtarın klasörünü listeler.
  • "Benimle paylaşılanlar" boştur; arama, son açılanlar ve çöp yalnızca o klasörün içini gösterir.
  • Köke taşıma ve çöp kutusunu boşaltma yapılamaz.

Bir sitenin görsellerini yükleyen bir sunucu için önerilen budur: anahtar sızarsa yalnızca o klasör etkilenir.

Süre

Anahtar 30 gün, 90 gün, 1 yıl (önerilen) ya da süresiz olabilir. Süresi dolan anahtar 401 döner ve listende "süresi doldu" diye görünür.

Anahtarı güvende tutma

  • Ortam değişkeninde ya da bir gizli bilgi yöneticisinde sakla; koda yazma, commit'leme.
  • Tarayıcıdan ya da mobil uygulamadan doğrudan kullanma. Kendi sunucun aracılık etsin.
  • Her uygulama için ayrı anahtar oluştur; birini iptal etmek diğerlerini etkilemesin.
  • Geliştirici sayfasında son kullanım zamanını izle. Tanımadığın bir kullanım görürsen iptal et.

İptal etme

Drive → Geliştirici → anahtarın yanında İptal et. Anahtar hemen çalışmaz olur (401), geri alınamaz.

API'den de iptal edilebilir (yalnızca Drive arayüzünden ya da Kivilio hesabının kendi oturumuyla; bir API anahtarı başka anahtar oluşturamaz ya da iptal edemez):

DELETE /api/v1/keys/key_3f2a…

Sınırlar

Kullanıcı başına en fazla 20 etkin anahtar olabilir. Hız sınırı anahtar başına uygulanır (Sınırlar).