İçeriğe geç

Dosyalar

Klasörler ve listeleme

Klasör oluşturma, listeleme, sayfalama, arama, sıralama, taşıma ve çöp.

Dosya ve klasörler aynı türdür: DriveNode (kind: FILE ya da FOLDER).

Listeleme

GET /nodes:

Sorgu
parentIdKlasörün içi. Yoksa Drive'ım kökü
viewmine (varsayılan), shared, recent, pinned, trash
sortname (varsayılan; klasörler önce), updated, size
limit1–200, varsayılan 50
cursorÖnceki yanıtın nextCursor değeri
qAd araması (aşağıda)

Sayfalama

Yanıttaki nextCursor doluysa bir sonraki sayfayı aynı sorguya cursor ekleyerek iste; null ise son sayfadasın. İmleç opaktır, kendin üretme.

const BASE = "https://drive.kivilio.com";

/** Bir klasörün bütün öğeleri, sayfa sayfa (imleçle). parentId yoksa Drive'ım kökü. */
async function* listAll(parentId) {
  let cursor;
  do {
    const q = new URLSearchParams({ limit: "100", sort: "updated" });
    if (parentId) q.set("parentId", parentId);
    if (cursor) q.set("cursor", cursor);
    const res = await fetch(`${BASE}/api/v1/nodes?${q}`, {
      headers: { Authorization: `Bearer ${process.env.KIVILIO_API_KEY}` },
    });
    if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
    const page = await res.json();
    yield* page.items;
    cursor = page.nextCursor;
  } while (cursor);
}

let count = 0;
for await (const node of listAll()) {
  console.log(node.kind === "FOLDER" ? "[klasör]" : "[dosya] ", node.name);
  count++;
}
console.log(count, "öğe");

Arama

GET /nodes?q=rapor: kendi öğelerin ve seninle paylaşılanlar içinde ad araması. Büyük/küçük harf ve Türkçe karakterden bağımsızdır ("isik" "Işık"ı bulur). Arama sayfalanmaz; ilk limit sonuç döner.

Klasör ve düzenleme

İşlemİstek
Klasör açPOST /folders { "name": "Raporlar", "parentId": "…" }
Yeniden adlandırPATCH /nodes/{id} { "name": "Yeni ad.pdf" }
TaşıPATCH /nodes/{id} { "parentId": "…" } (null: köke)
SabitlePATCH /nodes/{id} { "pinned": true }
Tek öğe ve yoluGET /nodes/{id}

Çöp

  • DELETE /nodes/{id}: çöp kutusuna (30 gün sonra kalıcı silinir).
  • POST /nodes/{id}/restore: geri al.
  • DELETE /nodes/{id}?permanent=1: kalıcı sil (öğe önce çöpte olmalı).
  • DELETE /trash: çöp kutusunu boşalt.

Kota

GET /usage: kullanılan alan, ayrılan alan (süren yüklemeler) ve kota, bayt cinsinden metin olarak (büyük sayılar kaybolmasın diye).