API referansı · Uploadex

Genel bakış

Uploadex API, API anahtarının sahibi adına dosyaları programatik olarak yüklemenizi, listelemenizi ve meta verileri güncellemenizi sağlar. Her uç nokta bir REST kaynağıdır: JSON (veya ikili yüklemeler için çok parçalı) girer, JSON çıkar, yalnızca HTTPS.

Temel URL: https://uploadex.net/api/v1
Kimlik doğrulama: Authorization başlığında Bearer token'ları
Taşıma: Yalnızca HTTPS · TLS 1.2 veya 1.3
Kodlama: UTF-8 JSON · yüklemeler için multipart/form-data
Tarihler: UTC olarak ISO 8601 · 2026-04-21T08:12:04Z

Kimlik doğrulama

Her istek, Bearer token içeren bir Authorization başlığı içermelidir. Anahtarları geliştirici panelinizden oluşturun ve değiştirin.

Authorization: Bearer ux_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Anahtarlar ux_live_ ile başlar. Oluşturulduğunda yalnızca bir kez gösterilir — bunları bir gizli bilgi yöneticisinde saklayın. Anahtarlar belirli eylemlerle (files:read, files:write, upload veya *) kapsamlandırılabilir ve gelecekteki bir tarihte sona erecek şekilde ayarlanabilir.

API erişimi, API erişimi etkinleştirilmiş bir plan gerektirir. Hesap API erişimi olmayan bir plana düşürülürse, hesap yeniden yükseltilene kadar mevcut anahtarlar çalışmayı durdurur. Sızdırılan anahtarları geliştirici panelinden hemen iptal edin.

Hızlı başlangıç

Anahtarın çalıştığını doğrulamak için hesap bilgilerinizi çekin.

# Get your account info
curl https://uploadex.net/api/v1/account \
  -H "Authorization: Bearer $UX_API_KEY"

Yanıt · 200 OK

{
  "data": {
    "id":               "clxxxxxxxxxxxxxxxxxxxxxx",
    "email":            "[email protected]",
    "name":             "Your Name",
    "plan":             "PRO",
    "balance":          0,
    "totalEarnings":    0,
    "storageUsed":      52428800,
    "storageLimit":     53687091200,
    "storageFormatted": "50 MB / 50 GB",
    "fileCount":        3,
    "createdAt":        "2026-04-01T09:21:00.000Z"
  }
}

Plan limitleri

Yükleme ve depolama limitleri plana bağlıdır ve hesap yükseltildiğinde veya düşürüldüğünde değişebilir. API erişimi içeren planların limitleri:

Plan	Maks. dosya boyutu	Depolama
Pro	10 GB	100 GB
Business	50 GB	1 TB
Business Plus	100 GB	5 TB

Hız limitleri

Hız limitleri, hizmeti kontrolsüz trafikten korur. Bir limitin aşılması 429 Too Many Requests döndürür.

Kapsam	Limit	Zaman aralığı	Özne
Yükleme başlatma	30	1 min	API anahtarı başına
İndirme	60	1 min	IP başına
Giriş	10	15 min	IP başına
Kayıt	5	1h	IP başına

Hatalar

Hata yanıtları, standart HTTP durum kodları ve tutarlı bir JSON gövdesi kullanır.

{ "error": "Invalid or missing API key" }

Durum	Anlamı
400	İstek gövdesi hatalı biçimlendirilmiş veya doğrulamayı geçememiş.
401	Eksik veya geçersiz API anahtarı.
403	Anahtar, gerekli bir kapsamdan yoksun (örn. files:write).
404	Kaynak mevcut değil veya anahtar sahibine ait değil.
413	Dosya, hesabın plan dosya boyutu limitini aşıyor.
429	Hız limiti aşıldı. Yavaşlayın ve yeniden deneyin.
500	Dahili hata. Yeniden denemeden önce durum sayfasını kontrol edin.

Sayfalama

Liste uç noktaları sayfa tabanlı sayfalama kullanır. Sorgu parametreleri olarak page (1'den başlayan) ve limit (maks. 100) değerlerini iletin.

GET /api/v1/files?page=1&limit=50

Hesap

GET/api/v1/account

Hesap bilgilerini, planı, depolama kullanımını, dosya sayısını döndürür.

Kapsam: geçerli bir anahtarın ötesinde bir kapsam gerekmez.

Yükleme

POST/api/v1/upload

Çok parçalı bir yükleme başlatır. İstemcinin parçaları R2 nesne depolamasına PUT etmek için kullandığı önceden imzalanmış URL'leri döndürür.

Alan	Tür	Açıklama
filename	string · required	Uzantı dahil dosya adı (maks. 255 karakter).
size	integer · required	Bayt cinsinden toplam dosya boyutu.
contentType	string · required	MIME türü (maks. 200 karakter).

Kapsam: upload. size hesabın plan limitini aşarsa 413 döndürür.

Dosyalar

GET/api/v1/files

Anahtarın sahip olduğu dosyaları listeler. page, limit (maks. 100), status destekler.

GET/api/v1/files/:id

ID'ye göre tek bir dosya alır.

PATCH/api/v1/files/:id

displayName, description, tags veya visibility günceller.

DELETE/api/v1/files/:id

Dosyayı siler ve depolama kotasını geri kazanır.

{
  "data": {
    "id":            "clxxxxxxxxxxxxxxxxxxxxxx",
    "slug":          "9nK2xA",
    "filename":      "demo.mp4",
    "size":          881975296,
    "sizeFormatted": "841.1 MB",
    "mimeType":      "video/mp4",
    "status":        "READY",
    "scanStatus":    "CLEAN",
    "downloads":     128,
    "views":         412,
    "tags":          ["demo"],
    "visibility":    "PUBLIC",
    "adsEnabled":    true,
    "createdAt":     "2026-04-21T08:12:04.000Z",
    "updatedAt":     "2026-04-21T08:12:04.000Z"
  }
}

Kapsamlar: GET, files:read gerektirir; PATCH/DELETE, files:write gerektirir.

Uploadex API referansı.