Conectar un servicio web mediante OAuth 2.0
OAuth 2.0 permite autorizar acceso a recursos de otra cuenta sin tratar la conexión como un acceso ilimitado. Necesitas las credenciales del cliente, los scopes adecuados y los endpoints del proveedor.
El título no significa que cualquier servicio sea compatible sin configuración. Este ejemplo sigue el recorrido de Dropbox documentado por Make. Consulta los requisitos del proveedor si conectas otra API.
Crea la aplicación en Dropbox
- Entra en Dropbox Developers y crea una aplicación.
- El ejemplo de Make selecciona Scoped access, Full Dropbox, un nombre y Create app. Antes de conceder ese acceso, comprueba que sea el apropiado para tu caso.
- En Settings, registra como Redirect URI la dirección que requiere el ejemplo:
https://www.integromat.com/oauth/cb/oauth2. Pulsa Add. - Guarda de forma privada App key y App secret; corresponden a Client ID y Client Secret.
- En Permissions, selecciona los scopes necesarios para la acción y pulsa Submit. Esos mismos permisos deben figurar en la conexión.
No publiques el secreto en una captura, una hoja de cálculo ni un mensaje de soporte.
Configura la conexión HTTP en Make
Añade HTTP > Make a request, elige OAuth 2.0 en Authentication type y abre Create a connection en Credentials.
| Campo | Valor del ejemplo |
|---|---|
| Connection name | Un nombre que identifique tu cuenta y uso |
| Flow type | Authorization Code |
| Authorize URI | https://www.dropbox.com/oauth2/authorize |
| Token URI | https://api.dropboxapi.com/oauth2/token |
| Scope | Los scopes seleccionados para la acción |
| Client ID | Tu App key |
| Client Secret | Tu App secret |
En Advanced settings > Authorize parameters, el ejemplo añade token_access_type con valor offline y force_reapprove con valor true. Son parámetros de Dropbox; no los copies a otro proveedor como si fueran universales.
Guarda y completa la autorización en la ventana que aparece. Revisa la cuenta y los permisos antes de aceptar.
Prueba creando una carpeta
La prueba tiene un efecto real: crea una carpeta. Hazla en una cuenta y ubicación donde tengas permiso.
- En URL, escribe
https://api.dropboxapi.com/2/files/create_folder_v2. - Selecciona POST.
- Deja vacíos Header y Query, tal como indica el ejemplo.
- En Body content type, elige application/json.
- En Body input method, selecciona Data structure.
- Crea una estructura con
pathde tipo texto y, si lo usas,autorenamede tipo booleano. - Introduce
/Makeenpathy desactivaautorename. - Guarda, ejecuta el módulo y revisa tanto la salida como la carpeta en Dropbox.
Los detalles de la operación deben contrastarse con la referencia de la API de Dropbox.
Alternativa: la aplicación Dropbox
Añade Dropbox > Create a Folder. Abre Create a connection o Add, asigna un nombre y completa los campos de Client ID, Client Secret y Scope que solicite el formulario. Guarda y autoriza.
Configura Folder Name con «Make» y selecciona la carpeta de destino adecuada. Ejecuta la prueba y comprueba el resultado. No hace falta repetir la creación por ambas rutas si solo quieres validar una conexión.
Si falla
Recomendación editorial: compara la URI de retorno de forma exacta, comprueba que los scopes se guardaron tanto en Dropbox como en Make y revisa la respuesta de la API. No concedas permisos más amplios indiscriminadamente para ocultar un error.
Fuente
Adaptación editorial de la fuente oficial de Make.