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 | |
|---|---|
parentId | Klasörün içi. Yoksa Drive'ım kökü |
view | mine (varsayılan), shared, recent, pinned, trash |
sort | name (varsayılan; klasörler önce), updated, size |
limit | 1–200, varsayılan 50 |
cursor | Önceki yanıtın nextCursor değeri |
q | Ad 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ır | PATCH /nodes/{id} { "name": "Yeni ad.pdf" } |
| Taşı | PATCH /nodes/{id} { "parentId": "…" } (null: köke) |
| Sabitle | PATCH /nodes/{id} { "pinned": true } |
| Tek öğe ve yolu | GET /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).