Verifica la dimensione di un file durante un caricamento API

dosya controlla la dimensione dichiarata prima di accettare i byte e misura il corpo durante la lettura. I caricamenti in una sola richiesta richiedono un Content-Length decimale; oltre 50 MiB occorre usare una sessione di caricamento.

Prima di iniziare

• Controlla max_file_size_bytes della chiave API, la quota di spazio di archiviazione e l’impostazione max_file_size_gb dello spazio di lavoro. I caricamenti REST non applicano un limite di dimensione del file a livello di ruolo.
• La chiave deve poter accedere allo spazio di lavoro scelto e il ruolo del membro deve consentire upload_files e access_upload per questa modalità di caricamento REST.
• Calcola un digest SHA-256 di 64 caratteri in minuscolo quando conta l’identità dei byte da un capo all’altro.
• Considera Content-Length un controllo, non una prova della dimensione archiviata; la ricevuta finale riflette i byte effettivamente ricevuti.

Passaggi

1. Misura la sorgente prima del trasferimento. Usa il caricamento in una richiesta fino a 50 MiB inclusi; oltre questa soglia inizializza un caricamento riprendibile.
2. Per il trasferimento in una richiesta invia Content-Length composto solo da cifre. Se la lunghezza manca o non è valida, il server restituisce 411; oltre 50 MiB restituisce 413 con Files over 50 MB use /api/upload/init and the resumable upload.
3. Aggiungi X-Dosya-Sha256: digest quando disponibile. Se i valori non corrispondono, il server restituisce 400 con hash_mismatch e i valori atteso e ricevuto.
4. Invia il corpo conservando lo stato e l’errore JSON. Se il corpo misurato supera il buffer consentito, il server può restituire 413 con upload_declared_size_mismatch.
5. Gestisci i rifiuti in base al motivo indicato: This API key does not permit files larger than N bytes (max_file_size_bytes), File exceeds the X GB size limit for this workspace o la risposta relativa alla quota di archiviazione.
6. Se il caricamento riesce, leggi dalla ricevuta la dimensione effettivamente archiviata e l’ID file, poi recupera i metadati. Non rifiutare un caricamento riuscito solo perché sono arrivati meno byte di quelli dichiarati; decidi in base al risultato misurato e al digest.

Risultato previsto

Un corpo consentito produce una ricevuta la cui dimensione misurata coincide con i metadati e un eventuale SHA-256 conferma i byte. Un input troppo grande, non consentito o corrotto viene rifiutato prima di diventare un risultato attendibile.

Risoluzione dei problemi

Il server restituisce 411. Indica la lunghezza effettiva in byte come numero decimale; un trasferimento a blocchi in una richiesta non soddisfa questo requisito.

Il file supera 50 MiB. Usa /api/upload/init, blocchi da 10 MiB e la route di completamento.

Le dimensioni dichiarata e archiviata differiscono. Considera attendibile la ricevuta, confronta il digest e controlla il produttore dei dati prima di continuare.

Guide correlate

• Carica tramite API
• Guida rapida all’API REST