Aggiungere un canale Dropbox

Prima di iniziare

Requisito	A cosa serve
Account Dropbox	Per accedere e autorizzare l'app
App Dropbox	Per generare App Key e App Secret
Dominio ImgBed	Per l'URI di redirect OAuth
Spazio Dropbox disponibile	Archivio effettivo dei file

Configurazione

Passaggio 1: crea un'app Dropbox

1. Apri Dropbox App Console:

https://www.dropbox.com/developers/apps

2. Crea una nuova app.
3. Come tipo di accesso scegli:

App folder

4. Dai all'app un nome riconoscibile, per esempio imgbed-app.
5. Dopo la creazione apri la pagina dettagli dell'app.

Tipo di accesso consigliato:

Tipo di accesso	Consiglio
App folder	Consigliato. È coerente con il modo in cui ImgBed archivia i file.
Full Dropbox	Non consigliato. ImgBed non ha bisogno di accesso completo all'account.

Passaggio 2: aggiungi la Redirect URI

Nella pagina dettagli dell'app Dropbox trova le impostazioni OAuth o Redirect URI e aggiungi:

https://your-domain.com/api/oauth/dropbox/callback

Se usi il pannello admin da più domini, aggiungi ogni URL di callback corrispondente.

Passaggio 3: configura i permessi dell'app

Apri la scheda Permissions e abilita almeno questi scope:

Scope	Obbligatorio	Scopo
account_info.read	Sì	Legge informazioni account e quota
files.metadata.read	Sì	Legge metadati di file e cartelle per i controlli di percorso
files.metadata.write	Sì	Crea cartelle e scrive metadati
files.content.write	Sì	Carica file. Senza questo scope compare required scope 'files.content.write'.
files.content.read	Consigliato	Permette download, anteprima e link temporanei

Dopo aver selezionato gli scope, clicca su Submit in fondo alla pagina.

Importante:

Situazione	Cosa fare
Hai modificato gli scope	Esegui di nuovo l'autorizzazione e ottieni un nuovo Refresh Token.
Non hai riautorizzato	Il vecchio token non acquisisce i nuovi permessi; gli upload possono continuare a fallire.

Passaggio 4: copia le credenziali dell'app

Salva questi due valori dalla pagina dell'app Dropbox:

Campo Dropbox	Campo ImgBed
App key	App Key
App secret	App Secret

Passaggio 5: compila il canale Dropbox

In Impostazioni di caricamento scegli Dropbox e compila:

Campo ImgBed	Cosa inserire
Nome canale	Un nome riconoscibile, per esempio Main Dropbox
App Key	App key di Dropbox
App Secret	App secret di Dropbox
Refresh Token	Lascialo vuoto per ora
Directory radice	Opzionale. Default imgbed.
Nota	Opzionale

Passaggio 6: ottieni il Refresh Token

1. In ImgBed clicca su Get Token.
2. Accedi con l'account Dropbox da collegare.
3. Approva la richiesta di autorizzazione.
4. La pagina di callback mostrerà un Refresh Token.
5. Copialo.
6. Torna in ImgBed e incollalo nel campo Refresh Token.

Verifica

Controllo	Risultato atteso
Scheda canale	Il canale Dropbox compare dopo il salvataggio.
Interruttore canale	Il canale può essere abilitato.
Token salvato	La pagina dettaglio mostra che il Refresh Token è stato salvato.
Upload di prova	Un'immagine di prova compare nella cartella dell'app Dropbox.

Se i limiti quota sono attivi, esegui la query quota. Dopo una query riuscita, la scheda mostra spazio usato, spazio totale e ultimo aggiornamento.

Risoluzione problemi

Problema	Soluzione
ImgBed segnala configurazione incompleta	Verifica che App Key, App Secret e Refresh Token siano compilati.
L'autorizzazione riesce ma non compare il Refresh Token	Clicca di nuovo Get Token e assicurati che venga usato il flusso offline.
Upload fallisce con required scope 'files.content.write'	Abilita files.content.write, clicca Submit, poi ottieni un nuovo Refresh Token.
Callback fallisce	Conferma che la redirect URI sia https://your-domain.com/api/oauth/dropbox/callback.
File non trovati	Verifica che l'app Dropbox sia stata creata in modalità App folder.

Flusso rapido

Apri Dropbox App Console
-> Crea un'app
-> Scegli accesso App folder
-> Aggiungi https://your-domain.com/api/oauth/dropbox/callback
-> Abilita account_info.read / files.metadata.read / files.metadata.write / files.content.write
-> Opzionalmente abilita files.content.read
-> Clicca Submit
-> Copia App Key e App Secret
-> Inseriscili in ImgBed
-> Clicca Get Token
-> Copia il Refresh Token dalla pagina di callback
-> Incollalo in ImgBed e salva

Riferimenti

1. Dropbox App Console: https://www.dropbox.com/developers/apps
2. Dropbox OAuth Guide: https://developers.dropbox.com/oauth-guide
3. Dropbox Developer Guide: https://www.dropbox.com/developers/reference/developer-guide