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.
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.

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.

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?