VERICLOUD API

Basit REST dosya API’si.

Dosya yükleme, listeleme, indirme, paylaşma ve silme işlemlerini Bearer token ile uygulamana ekle.

TEMEL URL

https://api.vericloud.com.tr

üretimde bu adres üzerinden sunulacaktır — yerelde http://localhost:3000

Kimlik doğrulama

İki ayrı yetki kanalı vardır — karıştırma:

Panel oturumu · JWT

Authorization: Bearer eyJhbGciOi...

/api/files, /api/upload, /api/shares gibi web uçları için kullanılır. Giriş yaptığında panel bu tokenı otomatik yönetir.

API anahtarı · df_

Authorization: Bearer df_9x2Kq7...

Yalnızca /api/v1/* uçlarıyla çalışır. Dashboard → API Anahtarları bölümünden oluşturulur; anahtar yalnızca bir kez gösterilir.

Endpoint’ler

Web uçları (JWT oturumu):

POST/api/auth/registerYeni kullanıcı hesabı oluşturur (kayıt açıksa).

POST/api/auth/loginKullanıcı adı/e-posta ve şifreyle oturum açar.

GET/api/filesKullanıcının dosyalarını listeler (JWT).

POST/api/uploadKüçük dosyayı multipart form ile yükler (JWT).

POST/api/upload/chunk/initBüyük dosya yükleme oturumu başlatır.

POST/api/upload/chunk/{id}/{index}Dosyanın bir parçasını gönderir.

POST/api/upload/chunk/{id}/completeParçaları birleştirme ve depolama işlemini başlatır.

GET/api/upload/progress/{id}Yükleme ve depolama ilerlemesini döndürür.

GET/api/file/{id}Dosyayı indirir; HTTP Range desteklenir (JWT).

PATCH/api/files/{id}Dosyayı yeniden adlandırır.

DELETE/api/files/{id}Dosyayı kalıcı olarak siler.

GET/api/foldersKlasörleri listeler.

POST/api/foldersYeni klasör oluşturur.

GET/api/sharesPaylaşım bağlantılarını listeler.

POST/api/sharesYeni paylaşım bağlantısı oluşturur.

GET/api/api-tokensAPI anahtarlarını listeler.

POST/api/api-tokensYeni API anahtarı (df_ başlangıçlı) oluşturur.

Public API (df_ API anahtarı — scriptler için):

POST/api/v1/uploadDosyayı Bearer df_ tokenı ile yükler (multipart).

GET/api/v1/filesAPI anahtarıyla dosya listesi.

GET/api/v1/files/{id}/downloadAPI anahtarıyla indirme (Range destekli).

DELETE/api/v1/files/{id}API anahtarıyla dosya silme.

Büyük dosya yükleme

Büyük dosyalar istemci tarafında güvenli parçalara ayrılır. Akış: oturum başlat → parçaları sırayla gönder → tamamla → progress endpoint’ini izle.

POST /api/upload/chunk/init
POST /api/upload/chunk/{uploadId}/0
POST /api/upload/chunk/{uploadId}/1
POST /api/upload/chunk/{uploadId}/complete
GET  /api/upload/progress/{uploadId}

Yanıt ve hata biçimi

{
  "success": false,
  "error": "Açıklayıcı hata mesajı",
  "code": "ERROR_CODE"
}

VeriCloud API · İlk sürüm dokümantasyonu · Hesap oluştur