Paylaşım
Paylaşım
Kişiye paylaşım ve süreli bağlantılar.
Paylaşım uçları drive:share yetkisi ister ve yalnızca öğenin sahibi kullanabilir.
Kişiye paylaşım
POST /nodes/{id}/shares gövdesi { "email": "[email protected]", "role": "VIEWER" }:
| Rol | |
|---|---|
VIEWER | Görür ve indirir |
EDITOR | Ayrıca klasöre yükler, yeniden adlandırır, çöpe atar |
Klasör paylaşımı alt öğelere geçer. Kişi henüz Kivilio'ya girmediyse paylaşım bekler (pending: true) ve doğrulanmış e-postasıyla ilk girişinde bağlanır.
- Liste:
GET /nodes/{id}/shares - Rol değiştir:
PATCH /nodes/{id}/shares?shareId=…gövdesi{ "role": "EDITOR" } - Kaldır:
DELETE /nodes/{id}/shares?shareId=…
Süreli bağlantı
1, 7 ya da 30 gün geçerli, girişsiz bir bağlantı:
const BASE = "https://drive.kivilio.com";
// 7 gün geçerli bağlantı. Önceki bağlantı iptal olur; token yalnızca bu yanıtta görünür.
const res = await fetch(`${BASE}/api/v1/nodes/${process.env.FILE_ID}/link`, {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.KIVILIO_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ days: 7 }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
const link = await res.json();
console.log(link.url, "→", link.expiresAt);- Bir öğenin aynı anda tek etkin bağlantısı olur; yenisi eskisini iptal eder.
- Bağlantının token'ı yalnızca oluşturma yanıtında döner. Kivilio yalnızca özetini saklar; kaybedersen yenisini oluştur.
- Etkin bağlantıyı görmek:
GET /nodes/{id}/link(token'sız). İptal:DELETE /nodes/{id}/link.
Süreli bağlantısı olan bir dosyanın visibility değeri link görünür.