Através deste guia, demonstraremos como gerar um arquivo PDF a partir de um documento através de nossa API REST. Ao seguir os passos deste guia, em poucos minutos você será capaz de obter um arquivo PDF do documento desejado.
Você já sabe, mas não custa lembrar: Um envelope possui um ou mais documentos. O documento em questão deverá estar dentro de um envelope.
Antes de iniciar sua integração:
Certifique-se que você possui credenciais válidas para utilizar o Unico Sign. Se você ainda não possui suas credenciais, siga nosso guia de Primeiros Passos para configurar sua conta de teste e obter suas chaves de API.
Entenda os conceitos básicos sobre nosso produto. É extremamente importante que você entenda estes conceitos para fazer uma boa utilização das APIs do Unico Sign. Você pode encontrar nossos conceitos básicos neste guia.
Como explicamos em nosso guia de conceitos básicos, Documentos (document) são a representação virtual de um documento que deve ser assinado (por um ou mais assinanates) e pode ser gerado a patir de um arquivo PDF ou de um modelo (Template). Os documentos estão contidos dentro de um envelope, que por sua vez pode conter um ou mais documentos.
Entenda a seguir, como obter um arquivo PDF de um documentos pertencente a um de seus envelopes:
Para efetuar requisições à nossa API REST você necessitará de um token de acesso OAuth válido. Caso não esteja familiarizado com o modelo de autenticação OAuth, entenda como gerar um token válido neste artigo. Após sua geração, o token de acesso deverá ser enviado no header de sua requisição, junto ao parâmetro Authorization.
Ambientes
Ao iniciar sua integração você receberá credenciais a nosso ambiente de homologação. Somente após o processo de testes e certificação você receberá credenciais de produção.
Você deverá apontar suas requisições às URLs corretas em cada estágio de sua integração. Abaixo listamos as URLs de homologação e produção:
Ambiente de homologação: https://signhom.acesso.io;
Ambiente de produção: https://sign.acesso.io.
/file/Após gerar um token de acesso válido, faça uma requisição para o endpoint de geração de arquivos PDF de nossa API REST (GET/service/file), especificando qual documento deseja como um parâmetro no path da requisição.
Abaixo um exemplo da requisição:
Não se esqueça de substituir o parâmetro DOCUMENT_UUID na requisição abaixo. Este parâmetro deve conter o UUID do documento ao qual você deseje gerar as evidências.
Exemplo de formato de um UUID: 00000000-0000-0000-0000-000000000000
Se tudo der certo em sua requisição, você receberá como resposta o arquivo binário do PDF.
Conheça as funcionalidades disponíveis para o Gerenciamento de documentos.
Conheça as funcionalidades disponíveis para o Gerenciamento de envelopes.
Tendo problemas em nossa integração? Acesse nossa seção de FAQ e problemas comuns.
Dúvidas?
Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.