İçeriğe geç

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
VIEWERGörür ve indirir
EDITORAyrı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.