Listar documentos
Esse endpoint possui um cache com expiração de 60 segundos.
Listar documentos
GET
https://api.zapsign.com.br/api/v1/docs/?page=1
Esse endpoint permite que você liste todos os documentos da sua conta.
Query Parameters
Name | Type | Description |
---|---|---|
page | number | Page vai de 1 a N (qualquer número inteiro positivo). Por default, este endpoint retorna a lista de documentos na sua conta ordenada em páginas com 25 documentos cada. Assim, para ir para a próxima página, mude o "page=N" na requisição. |
Headers
Name | Type | Description |
---|---|---|
Authorization* | string | Api token a frente do texto "Bearer". Ex: Bearer c7f35c84-7893-4087-b4fb-d1f06c23 |
Filtrando documentos de uma pasta
Caso você deseje filtrar apenas documentos de uma determinada pasta, acrescente ao GET o parâmetro opcional "folder_path". Por exemplo:
Todos documentos da conta (sem filtro de pasta): https://api.zapsign.com.br/api/v1/docs/?page=1
Filtrando somente documentos Sem pasta (ou seja, na raiz "/"): https://api.zapsign.com.br/api/v1/docs/?page=1&folder_path=/
Filtrando somente documentos na pasta "/api/pasta2/": https://api.zapsign.com.br/api/v1/docs/?page=1&folder_path=/api/pasta2/
Filtrando documentos excluídos ou não excluídos
Caso você deseje filtrar apenas documentos excluídos ou não excluídos, acrescente ao GET o parâmetro opcional "deleted". Por exemplo:
Apenas documentos não excluídos: https://api.zapsign.com.br/api/v1/docs/?page=1&deleted=false
Apenas documentos excluídos: https://api.zapsign.com.br/api/v1/docs/?page=1&deleted=true
Dica: em vez de consultar os documentos várias vezes ao dia, utilize nossos webhooks. Além de ser uma economia da capacidade computacional dos nossos e seus servidores, você também conseguirá dar um feedback em tempo real ao seu usuário, e não a cada N minutos.
Exemplo de resposta
Atenção: os links retornados em original_file e signed_file são temporários e duram 60 minutos. Caso seu sistema necessite salvar estes links é recomendado que sejam baixados em uma CDN própria ou que este endpoint seja consultado sempre para garantir que seu usuário sempre receberá um link válido.
Last updated