Upload-Limits

Die aktuelle Public API akzeptiert unter POST /api/v1/files Dateien bis 100 MiB (104.857.600 Bytes).

Warum sich das Limit von der App unterscheidet

Uploads über die Public API laufen derzeit durch den New-Archive-App-Server: Der Request wird in eine temporäre Datei gestreamt und anschließend in S3 gespeichert. Das 100-MiB-Limit begrenzt Netzwerk-Traffic, temporären Speicherbedarf und die Laufzeit eines einzelnen HTTP-Requests.

Die Browser-App verwendet einen anderen Transport. Sie erstellt einen S3- Multipart-Upload und überträgt 10-MiB-Parts mit kurzlebigen Presigned URLs direkt vom Browser zum Object Storage. Dieser nur für die App verfügbare Flow akzeptiert Dateien bis 2 GiB.

Dateien über 100 MiB

API-Keys können die Presigned-Multipart-Prozeduren der App derzeit nicht verwenden. Dateien zwischen 100 MiB und 2 GiB müssen daher über die New-Archive-App hochgeladen werden. Ein größerer Request aktiviert keinen Direct-to-S3-Upload.

json

{
  "error": {
    "code": "payload_too_large",
    "message": "File exceeds the 104857600 byte direct-upload cap"
  }
}

Ein zukünftiger Public-Multipart-Flow kann das API-Limit erhöhen, ohne Dateidaten durch den App-Server zu leiten. Bis dieser veröffentlicht und dokumentiert ist, bleibt 100 MiB das verbindliche Public-API-Limit.

ZurückSuchen WeiterFehler