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
| Yetki | Ne yapar |
|---|---|
drive:read | Listeleme, arama, tek öğe, indirme, önizleme, kullanım |
drive:write | Yükleme, klasör, yeniden adlandırma, taşıma, çöp, kalıcı silme |
drive:share | Kiş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
404döner; varlığı bile görünmez. parentIdvermeden 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).