¿Cómo integrar Dropbox en tus aplicaciones?

Para poder integrar Dropbox en nuestras aplicaciones, el requisito fundamental, es tener una cuenta en Dropbox. En caso de tenerla, habría que iniciar sesión, con nuestro correo y nuestra contraseña. Si no se tiene una cuenta en Dropbox, para registrarse habría que entrar en la página web principal de Dropbox, en www.dropbox.com, y pinchar en Registrarse. Una vez registrados, ya podemos iniciar sesión.

Una vez que tenemos la sesión iniciada, pinchamos en los tres puntos suspensivos de la esquina inferior derecha, y en Desarrolladores. Posteriormente tenemos que pinchar en Consola de aplicación, y nos saldrá la siguiente imagen:

Esta ventana corresponde a las aplicaciones que tenemos para nuestra API de Dropbox. Para poder integrar Dropbox en nuestras aplicaciones, habrá que pinchar en el botón Create app. Una vez pinchado, nos saldrá la siguiente ventana:

Tenemos que pinchar en el punto de al lado de Scoped access New, y nos saldrá lo siguiente:

Si solamente nos interesa tener acceso a una carpeta en concreto de nuestra nube de Dropbox, pinchamos en App folder. De lo contrario, si queremos obtener acceso a toda nuestra nube de Dropbox pinchamos en Full Dropbox.

El último paso, sería poner nombre a nuestra aplicación:

Una vez hecho, pinchamos en el botón Create app.

Una vez creada nuestra aplicación, pinchamos en la pestaña Permissions, y nos saldrá la siguiente imágen:

Si quisiéramos leer el contenido de nuestro Dropbox, tendríamos que tener marcado el permiso files.content.read. Si queremos, subir un archivo, descargar un archivo o eliminar un archivo, tendríamos que tener marcado el permiso files.content.write. Una vez marcados los permisos que nos interesan, nos vamos a la pestaña Settings, y a donde pone OAuth 2:

Para permitir clientes públicos, habrá que tener seleccionada la opción Allow de Allow public clients (Implicit Grant & PKCE). Si nos interesa que expire el token nos vamos a Access token expiration y a Short-lived. De lo contrario, si no nos interesa que expire nunca, pinchamos en No expiration. Una vez hecho todo esto, pinchamos en Generate y generamos el token. Una vez generado dicho token lo guardamos para usarlo en nuestras aplicaciones.

NOTA IMPORTANTE: La modificación de los permisos en nuestra aplicación, implicará la invalidez del token, con lo que habrá que generar otro nuevo token pulsando en el botón Generate.

Para poder utilizar Dropbox en nuestra aplicación programada en Node.js, el primer paso es instalar Dropbox de la siguiente forma:

npm install --save dropbox

Una vez instalado, un ejemplo de uso podría ser el siguiente:

var Dropbox = require('dropbox').Dropbox;
var dbx = new Dropbox({ accessToken: 'YOUR_ACCESS_TOKEN_HERE' });
dbx.filesListFolder({path: ''})
.then(function(response) { console.log(response); })
.catch(function(error) { console.log(error); });

Para más información sobre la documentación de la API en Node.js de Dropbox, pinchar en el siguiente enlace:

Dropbox Node SDK Class: Dropbox