İçeriğe geç

Paylaşım

Gizlilik ve herkese açık adresler

private, link ve public; herkese açık adresi CDN gibi kullanmak.

Her dosyanın bir visibility değeri vardır:

DeğerKim görür
privateYalnızca sen ve kişiye paylaştıkların
linkAyrıca süreli bağlantıyı bilen herkes (Paylaşım)
publicAdresi bilen herkes, girişsiz; adres sabit ve önbelleklenir

Herkese açık yapma

PATCH /nodes/{id} gövdesi { "visibility": "public" }. drive:share yetkisi gerekir ve yalnızca dosyanın sahibi değiştirebilir. Şimdilik yalnızca dosyalar (klasörler değil).

curl -sS -X PATCH "https://drive.kivilio.com/api/v1/nodes/$FILE_ID" \
  -H "Authorization: Bearer $KIVILIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"visibility":"public"}'
# Yanıttaki "publicUrl": https://files.kivilio.com/{public_id}/{ad}

Yanıttaki publicUrl:

https://files.kivilio.com/x22hHiFNLEfOtuEe7LMMpr/logo.png
  • 22 karakterlik kimlik tahmin edilemez. Sondaki ad yalnızca okunurluk içindir; yanlış ad doğru adrese yönlendirilir (301).
  • Görsel, ses, video ve PDF tarayıcıda açılır. HTML, SVG, JavaScript ve diğer türler indirilir, tarayıcıda çalışmaz.
  • Range desteklenir (video ve ses oynatıcıları için).
  • Her yerden gömülebilir (Access-Control-Allow-Origin: *).

CDN gibi kullanmak

Herkese açık adres bir yıl önbelleğe alınabilir (Cache-Control: public, max-age=31536000, immutable). Bu şu anlama gelir:

  • Adres değişmez, içerik de değişmez. Bir dosyanın yeni sürümünü yayınlamak için yeni dosyayı yükle ve onu herkese açık yap; yeni bir adres alır. Sitende adresi güncelle.
  • Aynı dosyanın herkese açıklığını kapatıp yeniden açarsan yeni bir adres alır; eskisi ölür.
<img
  src="https://files.kivilio.com/x22hHiFNLEfOtuEe7LMMpr/logo.png"
  alt="Logo"
  width="160"
  height="40"
/>

Kapatma

{ "visibility": "link" } herkese açıklığı kapatır, süreli bağlantılar çalışmaya devam eder. { "visibility": "private" } ikisini birden kapatır.

Dosyayı çöp kutusuna atmak da herkese açıklığı kapatır; çöpten geri alınan dosya gizli döner.

İndirme sınırı

Herkese açık dosyalarının indirmeleri aylık bir çıkış sınırına sayılır (Sınırlar). Sınır dolunca adresler ay sonuna kadar 429 döner. Önbellekten verilen indirmeler sayılmaz.