Saltar al contenido
Centro de ayuda

Categorías

Buscar en el Centro de ayudaCtrl K
En esta página

Crear una aplicación o conectar webhooks

Crea una aplicación OAuth que otros usuarios de Drime conectan a su cuenta, recibe webhooks y los eventos de Drime Sign en tu servidor.

Actualizado Web

Para usar la API de Drime en tu propia cuenta, basta con un token personal: consulta Crear un token de API. Para crear una aplicación que otros usuarios de Drime conectan a sus cuentas, crea una aplicación OAuth: tus usuarios la aprueban en Drime y la aplicación nunca ve su contraseña.

#Crear una aplicación OAuth

Cualquier usuario que haya iniciado sesión puede crear aplicaciones desde el portal de desarrolladores, en Mis aplicaciones y luego Crear aplicación.

El formulario Crear aplicación del portal de desarrolladores con los tres tipos de aplicación

Primero eliges qué vas a crear:

Opción

Para

Un sitio web o un servidor

Recibes una clave secreta que guardas en tu servidor.

Una aplicación de escritorio o móvil

Se instala en los dispositivos de tus usuarios, así que no hay clave secreta.

Un script, solo para mí

Una pequeña herramienta que ejecutas tú.

Después eliges qué necesita la aplicación: Una carpeta propia (solo ve una carpeta, creada en el Drive) o Todo el Drive.

A tener en cuenta:

  • Puedes crear hasta 25 aplicaciones.

  • Una aplicación nueva funciona para un máximo de 25 usuarios. Para abrirla a más personas, usa Abrirla a todo el mundo y luego Enviar a revisión: Drime responde en un plazo de 24 horas.

  • Los tokens de acceso duran 1 hora y los tokens de actualización, 90 días.

  • Las aplicaciones de terceros nunca pueden acceder a un Vault.

Las aplicaciones de tipo Un sitio web o un servidor también pueden recibir webhooks cuando se crean o eliminan archivos en una cuenta conectada. Cada notificación va firmada en el encabezado X-Drime-Signature.

#Webhooks de Drime Sign

En Ajustes > Desarrolladores > Webhooks (Notificaciones HTTP de los eventos de Drime Sign.), haz clic en Añadir un webhook para que tu servidor reciba un aviso cuando, por ejemplo:

  • se envía, se completa o se rechaza un documento;

  • un firmante ve, firma o rechaza un documento;

  • se crea una plantilla.

La sección Webhooks de los ajustes de Desarrolladores con Añadir un webhook

Cada notificación va firmada con un secreto (X-Drime-Signature, HMAC SHA-256). Una notificación fallida se reintenta hasta 10 veces durante unas 34 horas. Puedes usar Enviar una prueba y Regenerar el secreto, y consultar las Entregas.

#Insertar un formulario de firma en tu sitio web

En Ajustes > Desarrolladores > Incrustación, puedes permitir que los visitantes firmen documentos sin salir de tu sitio web, con el widget <drime-sign-form>. Añade tus dominios en Dominios permitidos: sin ningún dominio, la incrustación está desactivada.

#Próximos pasos

¿Te ha resultado útil?