Histórico de atividades do documento
O intuito principal desse endpoint é possibilitar a recuperação do histórico de atividades para um documento especifico. A rota ainda provê a possibilidade de retorno no formato padrão JSON, ou em formato de arquivo PDF para download.
Coletar Histórico de atividades
GET
https://api.zapsign.com.br/api/v1/docs/signer-log/{{doc_token}}?download_pdf=boolean
Headers
Authorization*
string
Api token a frente do texto "Bearer".
Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23
Path Parameters
doc_token
string
O token do documento que se deseja analisar o histórico de atividades
Query Parameters
download_pdf
boolean
Valor que permite decidir o tipo de retorno que o endpoint irá devolver.
Ex.:
download_pdf=true
ou
download_pdf=false
Caso seja o valor atribuído seja true
O retorno será um arquivo PDF com o histórico de atividades nele.
Caso seja false
ou caso não esteja preenchido, será retornado, em formato JSON, um lista com os valores de cada atividade feita no documento pelo signatário.
Exemplos de retorno de sucesso:
[
{
"time": "2024-11-27 17:44:32.117577+00:00",
"user": "[email protected]",
"event": "Documento visualizado",
"description": "Documento visualizado por [email protected]"
},
{
"time": "2024-11-27 17:44:34.395952+00:00",
"user": "[email protected]",
"event": "Confirmação de leitura",
"description": "Confirmação de leitura de [email protected]"
},
{
"time": "2024-11-27 17:45:29.398835+00:00",
"user": "[email protected]",
"event": "Validação reconhecimento facial",
"description": "Validação do rosto de [email protected] com a foto do documento de identidade (anexo no relatório de assinaturas)"
},
{
"time": "2024-11-27 17:45:40.904009+00:00",
"user": "[email protected]",
"event": "Aceitação do processamento de dados pessoais",
"description": "[email protected] concordou com o processamento de dados pessoais de acordo com a Política de Privacidade"
},
{
"time": "2024-11-21 05:18:45.733798+00:00",
"user": "[email protected]",
"event": "Documento criado",
"description": "O documento foi criado por [email protected] via web"
}
]
Exemplos de retorno de erro:
Para este erro o endpoint retorna no atributo StatusCode o valor 401, indicando que o token enviado não tem permissão de visualizar os dados desse documento.
Para esse erro sugerimos que verifique se o token enviado nos Headers está correto de acordo como exemplo já descrito acima.
Last updated
Was this helpful?