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öntem | Adres | Açıklama |
|---|---|---|
| GET | /api/v1/me | Kullanı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/paylasimlar | Paylaşım bağlantıları |
| GET | /api/v1/cop-kutusu | Çöp kutusu |
| POST | /panel/yukle/baslat | Parçalı yükleme başlat: { name, size, sure, klasor?, ekip?, surum? } → { id, chunkSize, chunks } |
| PUT | /panel/yukle/:id?parca=N | Parça gövdesi (ham bayt, application/octet-stream); parçalar paralel gönderilebilir |
| POST | /panel/yukle/:id/bitir | Yüklemeyi tamamla → dosya kaydı |
| GET | /panel/dosya/:id/indir | İndir (Range destekli) |
| POST | /panel/dosya/:id/paylas | Bağlantı oluştur: { expiry?, password?, maxDownloads?, oneTime?, ipAllow?, approval?, commentsOn? } |
| POST | /panel/klasor | Klasör oluştur { name, parent? } |
| POST | /panel/toplu | Toplu işlem { action: 'tasi'|'sil'|'favori', files, folders, target? } |
| POST | /panel/dosya/:id/sil | Çöp kutusuna taşı |
| GET | /panel/dosya/:id/yorumlar | Yorumlar; 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.