Criar um aplicativo ou conectar webhooks

Para usar a API do Drime na sua própria conta, basta um token pessoal: consulte Criar um token de API. Para criar um aplicativo que outros usuários do Drime conectam às contas deles, crie um aplicativo OAuth: os usuários o aprovam no Drime, e ele nunca vê a senha deles.

#Criar um aplicativo OAuth

Qualquer usuário conectado pode criar aplicativos no portal do desenvolvedor, em Meus aplicativos e depois Criar aplicativo.

Primeiro, você escolhe o que está criando:

Depois, você escolhe do que o aplicativo precisa: Uma pasta própria (ele só vê uma pasta, criada no Drive) ou Todo o Drive.

Bom saber:

• Você pode criar até 25 aplicativos.

• Um novo aplicativo funciona para até 25 usuários. Para abri-lo para mais pessoas, use Abrir para todos e depois Enviar para análise: o Drime responde em até 24 horas.

• Os tokens de acesso duram 1 hora, e os tokens de atualização, 90 dias.

• Aplicativos de terceiros nunca podem acessar um Vault.

Os aplicativos do tipo Um site ou um servidor também podem receber webhooks quando arquivos são criados ou excluídos em uma conta conectada. Cada notificação é assinada no cabeçalho X-Drime-Signature.

#Webhooks do Drime Sign

Em Configurações > Desenvolvedores > Webhooks (Notificações HTTP dos eventos do Drime Sign.), clique em Adicionar um webhook para que seu servidor seja notificado quando, por exemplo:

• um documento é enviado, concluído ou recusado;

• um signatário visualiza, assina ou recusa;

• um modelo é criado.

Cada notificação é assinada com um segredo (X-Drime-Signature, HMAC SHA-256). Uma notificação que falha é reenviada até 10 vezes ao longo de cerca de 34 horas. Você pode usar Enviar um teste e Trocar o segredo, e conferir as Entregas.

#Incorporar um formulário de assinatura no seu site

Em Configurações > Desenvolvedores > Incorporação, você pode permitir que os visitantes assinem documentos sem sair do seu site, com o widget <drime-sign-form>. Adicione seus domínios em Domínios permitidos: sem nenhum domínio, a incorporação fica desativada.

#Próximos passos

• Criar um token de API

• Rclone, Drime CLI e WebDAV