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ğer | Kim görür |
|---|---|
private | Yalnızca sen ve kişiye paylaştıkların |
link | Ayrıca süreli bağlantıyı bilen herkes (Paylaşım) |
public | Adresi 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.
Rangedesteklenir (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.