Geliştirici

REST API

Hesabınızdaki dosyaları kendi yazılımınızdan yönetin. Kimlik doğrulama, Hesabım sayfasından üretilen erişim anahtarıyla yapılır; Windows uygulaması da aynı API'yi kullanır.

Kimlik doğrulama

Her isteğe Authorization: Bearer dlk_… başlığı ekleyin. Anahtar, hesabınızla aynı yetkilere sahiptir; Hesabım › Windows uygulaması ve erişim anahtarı bölümünden istediğiniz an iptal edebilirsiniz. CSRF belirteci gerekmez.

curl -H "Authorization: Bearer dlk_…" https://dosya.webdanismani.com/api/v1/me

Uç noktalar

YöntemAdresAçıklama
GET/api/v1/meKullanıcı, paket sınırları, takımlar, parça boyutu
GET/api/v1/dosyalar?klasor=&ekip=Klasör içeriği (dosyalar + alt klasörler)
GET/api/v1/paylasimlarPaylaşım bağlantıları
GET/api/v1/cop-kutusuÇöp kutusu
POST/panel/yukle/baslatParçalı yükleme başlat: { name, size, sure, klasor?, ekip?, surum? } → { id, chunkSize, chunks }
PUT/panel/yukle/:id?parca=NParça gövdesi (ham bayt, application/octet-stream); parçalar paralel gönderilebilir
POST/panel/yukle/:id/bitirYüklemeyi tamamla → dosya kaydı
GET/panel/dosya/:id/indirİndir (Range destekli)
POST/panel/dosya/:id/paylasBağlantı oluştur: { expiry?, password?, maxDownloads?, oneTime?, ipAllow?, approval?, commentsOn? }
POST/panel/klasorKlasör oluştur { name, parent? }
POST/panel/topluToplu işlem { action: 'tasi'|'sil'|'favori', files, folders, target? }
POST/panel/dosya/:id/silÇöp kutusuna taşı
GET/panel/dosya/:id/yorumlarYorumlar; POST ile { body } ekle
POST/api/v1/cihaz/kayit …Cihazdan cihaza aktarım rölesi (Windows uygulaması)

Örnek: dosya yükleme

const KEY = 'dlk_…', BASE = 'https://dosya.webdanismani.com';
const h = { authorization: `Bearer ${KEY}`, 'content-type': 'application/json' };
const start = await fetch(`${BASE}/panel/yukle/baslat`, { method: 'POST', headers: h, body: JSON.stringify({ name: 'rapor.pdf', size: buf.length, sure: '7d' }) }).then(r => r.json());
for (let i = 0; i < start.chunks; i++) {
  const part = buf.subarray(i * start.chunkSize, (i + 1) * start.chunkSize);
  await fetch(`${BASE}/panel/yukle/${start.id}?parca=${i}`, { method: 'PUT', headers: { authorization: h.authorization, 'content-type': 'application/octet-stream' }, body: part });
}
const done = await fetch(`${BASE}/panel/yukle/${start.id}/bitir`, { method: 'POST', headers: h }).then(r => r.json());
console.log(done.file.id);

Hatalar ve sınırlar

Hatalar JSON döner: { "error": "açıklama" }. 401 geçersiz anahtar, 403 yetki/paket sınırı, 413 boyut/kota, 429 hız sınırı (genel: dakikada 1500 istek). Yanıtlar UTF-8 JSON'dur; tarihler milisaniye cinsinden Unix zaman damgasıdır.