Creare una chiave API dosya per il solo caricamento

Una credenziale REST Solo caricamento può creare cartelle e caricare file, anche verificando lo stato del caricamento. Non può invece elencare i file.

Configurazione compatibile

Il riquadro del permesso indica Può caricare nuovi file. Non può leggere o eliminare quelli già presenti. Scegli la superficie API REST e, se possibile, vincola la chiave a uno spazio di lavoro. Un ancoraggio alla cartella blocca REST: scegli invece la destinazione con folder_id nel corpo di ogni richiesta di inizializzazione del caricamento.

Per un normale caricamento REST, il ruolo nello spazio di lavoro deve includere sia upload_files sia access_upload. Solo SFTP non richiede access_upload, perché access_sftp controlla l’accesso al gateway SFTP. Per creare una cartella di destinazione serve anche create_folders.

Passaggi

1. Apri Profilo → Chiavi API, premi Crea una chiave API, dai un nome all’attività di acquisizione e scegli Solo caricamento.
2. In Restrizioni e scadenza, attiva API REST, vincola la chiave allo spazio di lavoro di destinazione e non impostare l’ancoraggio alla cartella.
3. Genera il segreto, che viene mostrato una sola volta, poi avvia una piccola prova con un nome univoco usando POST /api/upload/init e il folder_id desiderato.
4. Invia i byte tramite gli URL single-PUT o multipart restituiti e conserva file.id e il size_bytes effettivo della risposta di completamento.
5. Esegui GET /api/files?workspace_id=wks_… con la credenziale di caricamento e verifica che la richiesta venga rifiutata per via dell’ambito, senza restituire un elenco.
6. Verifica il nuovo file tramite la ricevuta di completamento, l’interfaccia dosya o una credenziale di lettura fidata separata, poi revoca la chiave di prova se è sacrificabile.

Operazioni consentite e negate

L’intero prefisso /api/upload è considerato un’operazione di scrittura, incluso il percorso GET per lo stato: la chiave che ha creato una sessione può quindi riprenderla. Anche POST /api/folders è un’operazione di scrittura. Letture, spostamenti, eliminazioni e modifiche gestionali non sono consentiti con Upload only.

La richiesta di elenco rifiutata restituisce This credential's scope is 'upload' and cannot perform GET /api/files. Le regole su superficie, vincolo, ruolo, dimensione, quota, estensione, blocco e operazioni simultanee possono rifiutare prima un caricamento, con messaggi specifici.

Se esiste un file attivo omonimo, il caricamento può diventarne una nuova versione al completamento. Usa un nome di destinazione univoco se vuoi solo creare nuovi file. Il completamento conferma l’archiviazione e i metadati del file; per rimuoverlo segui la normale procedura del cestino.

Risultato previsto

La ricevuta del caricamento identifica il file archiviato, la destinazione viene verificata da una vista indipendente e la stessa chiave riceve un 403 quando tenta di elencare i file dello spazio di lavoro.

Guide correlate

• Creare una chiave API
• Scegliere gli ambiti della chiave