Dosyalar

Dosyalar ve klasörler sayfalar, nesneler ve e-posta tarafından kullanılan medya ve belgeleri saklar. REST API’de yüklemeler multipart’tır; MCP base64 alıp multipart’a çevirir.

Listeleme site erişimi ister. Yükleme ve değişiklikler yazılabilir dosya erişimi gerektirir.

Dosyalar

Dosya ve klasörleri birlikte listeleyin, multipart ile yükleyin (dosya başına en fazla 5 GB), klasörler arasında taşıyın veya soft-delete yapın. Sistem tarafından yönetilen favicon varlıkları listelerden hariç tutulur.

Dosya ve klasörleri listeleyin. İsteğe bağlı includeDeleted=true.

GET /api/v1/{locale}/{websiteId}/files

Dosya yükleyin (en fazla 5 GB). Multipart alan adı: file. İsteğe bağlı directory_id. Boyut aşıldığında hata, dosyanın boyutunu ve 5 GB üst sınırı gösterir.

POST /api/v1/{locale}/{websiteId}/files

Taşıyın (PATCH directoryId) veya soft-delete yapın.

PATCH|DELETE /api/v1/{locale}/{websiteId}/files/{fileId}

{
  "directoryId": "string | null"
}

MCP: get_files, upload_file (base64 içerik, çözülmüş en fazla 5 GB — assertWebsiteFileUploadSize), upload_file_from_url (yalnızca CDN/R2 hostları; diğerleri files.host_not_allowed döner), import_file_from_url (genel HTTPS görsel, SSRF korumalı, WebP’ye küçültülür; görsel olmayanlar ve 20 MB üstü gövdeler reddedilir), save_file, delete_file. ~1–2 MB üzerindeki base64 yerine upload_file_from_url veya REST multipart tercih edin.