Recupera i metadati di un file tramite l'identificatore API

L’endpoint per un singolo file restituisce in un record identità, archiviazione, posizione, versione, visibilità e conteggi di collaborazione. I campi nulli sono valori validi e non indicano necessariamente una ricerca senza esito.

Requisiti di accesso

Chiama GET https://api.dosya.dev/api/files/:id con una chiave Sola lettura o Accesso completo abilitata per API REST. La chiave può essere vincolata a uno spazio di lavoro, ma un vincolo a una cartella rende REST non disponibile. Il ruolo del membro corrente deve includere access_files.

Passaggi

1. Ottieni un ID file_… noto da un elenco attendibile, una risposta di caricamento o un webhook e conserva insieme a esso lo spazio di lavoro previsto.
2. Invia GET /api/files/:id con l’intestazione bearer e richiedi JSON invece di seguire un valore formattato per l’interfaccia.
3. Confronta file.id, workspace_id, folder_id e name con il record scelto dall’integrazione.
4. Confronta size_bytes, mime_type, extension, region, current_version, etag e content_hash con l’operazione da verificare.
5. Interpreta created_at e updated_at come secondi Unix e ammetti valori nulli come uploader_name o content_hash.
6. Registra i metadati necessari all’applicazione, ometti dai log pubblici i dettagli di visibilità o identità e gestisci 403/404 in base al corpo esatto della risposta.

Campi del file restituiti

Il corpo di una risposta riuscita è {ok:true,file:{…}}. L’oggetto file include id, name, size_bytes, mime_type, extension, region, uploaded_by, uploader_name, created_at, updated_at, deleted_at, lock_mode, is_hidden, hidden_mode, current_version, workspace_id, folder_id, content_hash, etag, share_count e comment_count.

content_hash:null è previsto per elementi che non hanno ancora ricevuto un hash verificato o calcolato su richiesta. Se manca la riga relativa all’autore del caricamento, uploader_name può essere nullo, mentre uploaded_by rimane presente.

Risultato previsto

HTTP 200 restituisce l’ID file e lo spazio di lavoro attesi da chi effettua la chiamata, con dimensione in byte e metadati di versione adatti a una decisione sull’integrità o sulla sincronizzazione.

Risoluzione dei problemi

Missing file ID è un errore 400 nell’input della route. File not found può indicare un’assenza o una decisione di nascondere o limitare l’accesso per tutelare la privacy. Un 403 può indicare appartenenza, permesso della pagina file, limiti della cartella del membro, blocco completo della cartella, ambito della chiave, superficie o vincolo allo spazio di lavoro. Non usare un ciclo generico di tentativi per queste condizioni.

Guide correlate

• Elenca i file con l’API
• Gestisci gli errori API