---
title: Solução de Problemas e Erros Comuns na API
description: Solução de Problemas e Erros Comuns na API
---
[Pular para o conteúdo](https://ajuda.d4sign.com.br/solução-de-problemas-e-erros-comuns-na-api#main-content)
[](https://www.d4sign.com.br)
- [Central de Conhecimento](https://ajuda.d4sign.com.br/)
Abrir navegação principal
Fechar navegação principal
- [Central de Conhecimento](https://ajuda.d4sign.com.br/)
- [Canais de Atendimento](https://ajuda.d4sign.com.br/contatos-d4sign-nossos-canais-de-atendimento)
[Canais de Atendimento](https://ajuda.d4sign.com.br/contatos-d4sign-nossos-canais-de-atendimento?hsLang=pt-br)
Como podemos ajudar?
- Não há sugestões porque o campo de pesquisa está em branco.
1. [Central de Conhecimento](https://ajuda.d4sign.com.br/?hsLang=pt-br)
2. [Perguntas Frequentes](https://ajuda.d4sign.com.br/perguntas-frequentes?hsLang=pt-br)
3. [Resolução de Problemas](https://ajuda.d4sign.com.br/perguntas-frequentes?hsLang=pt-br#resolu%C3%A7%C3%A3o-de-problemas)
# Solução de Problemas e Erros Comuns na API
## Ao integrar a D4Sign via API, é comum encontrar alguns erros. Este guia detalha os erros mais frequentes e como solucioná-los. Para auxiliar nos testes, recomendamos usar o Postman com a nossa coleção e consultar a documentação completa.
#### Para auxiliar nos testes, recomendamos usar o Postman com a nossa coleção e consultar a documentação completa.
- **Coleção Postman:** [https://app.getpostman.com/run-collection/5d43ba6b3834eb9f5c66](https://app.getpostman.com/run-collection/5d43ba6b3834eb9f5c66)
- **Central de Conhecimento API:** [https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br)
### Códigos de Resposta (Status Code)
- **200 OK:** A requisição foi processada com sucesso.
- **400 Bad Request:** A requisição enviada contém um erro. O problema está na sua solicitação (por exemplo, dados incorretos no `body`). Verifique a documentação para corrigir os parâmetros.
- **500 Internal Server Error:** Este erro indica um problema interno em nossos servidores. Embora seja raro, a mensagem de retorno será `{"message": "Server error."}`.
---
### Erros de Requisição Comuns
1. **"Esta chave da API já atingiu o tempo limite para este método"**
- **Motivo:** Sua chave de API atingiu o limite de requisições por hora para o método utilizado.
- **Solução:** Entre em contato com **comercial@d4sign.com.br** para verificar a possibilidade de aumentar seu limite. Se você já tem um plano com limite elevado, confirme se está usando a chave da conta correta.
2. **"file empty" (arquivo vazio)**
- **Motivo:** Erro de upload. Geralmente ocorre quando o arquivo referenciado no `body` da requisição não foi encontrado no seu dispositivo ou o caminho está incorreto.
3. **"message": null (400 - bad request)**
- **Motivo:** Erro genérico de `bad request`, que muitas vezes acontece quando o `body` da requisição está incorreto (por exemplo, um ID de template inválido).
- **Solução:** Revise o `body` da sua requisição, conferindo se todos os IDs e parâmetros estão corretos, conforme a documentação.
4. **"This account has no more limits to send documents"**
- **Motivo:** A sua conta excedeu o limite de envios de documentos.
- **Solução:** Entre em contato com **comercial@d4sign.com.br** para adquirir mais envios. Se você possui um plano e os envios foram desativados, fale com **finance@d4sign.com.br**.
5. **"It is not possible to use the authentication point 'certificadoicpbr' for your region"**
- **Motivo:** A requisição para assinatura com certificado digital está sendo feita de fora do Brasil ou com uma VPN ativada.
- **Solução:** É necessário realizar o processo em um ambiente localizado no Brasil para que a autenticação ICP-Brasil funcione corretamente.
6. **Falha ao receber notificações Webhook (Erro 500 ou 0)**
- **Motivo:** Seu servidor não está aceitando as notificações enviadas pela D4Sign.
- **Solução:** Inclua os seguintes IPs na `whitelist` (lista de permissões) do seu servidor para que ele possa receber as notificações do nosso webhook:
- `54.94.40.55```
7. **"Chave de API inválida" (401 - Unauthorized)**
- **Motivo:** `{"message":"API error: Check API user.","mensagem_pt":"Chave de API inválida."}`. A chave de API ou a `cryptKey` estão incorretas.
- **Solução:** Verifique os seguintes pontos: a chave foi digitada corretamente? A `cryptKey` está presente na requisição? Há espaços em branco antes ou depois das chaves? Você está usando a chave do ambiente de **produção** no `sandbox` ou vice-versa?
8. **"not permission this safe"**
- **Motivo:** O token de API e a `cryptKey` da conta que faz a requisição não têm permissão para acessar o cofre (`UUID`) especificado.
- **Solução:** Verifique se a conta de API tem acesso ao cofre compartilhado ou se o `UUID` do cofre está correto.
9. **"false - metodo desconhecido"**
- **Motivo:** A URL da requisição (`request`) está incorreta e o endpoint solicitado não existe.
- **Solução:** Revise a URL para garantir que ela corresponde exatamente ao formato da nossa documentação.
10. **`body` retorna vazio (código 200)**
- **Motivo (Sandbox):** Em algumas requisições no ambiente de testes, é normal receber um retorno vazio, mas o upload do documento pode ter sido feito com sucesso. Verifique se o documento foi criado.
- **Motivo (Produção):** Se isso ocorrer no ambiente de produção, pode ser um erro de formatação da requisição. Verifique se os IDs e os valores no `body` estão corretos e se a requisição foi estruturada conforme a documentação.
11. **Lentidão na requisição**
- **Motivo:** Pode ser um problema na sua conexão de rede, VPN, firewall ou dispositivo.
- **Solução:** Teste a requisição em outro ambiente, sem VPN ou em outro dispositivo, para isolar a causa do problema.
- [Treinamento](https://ajuda.d4sign.com.br/treinamento?hsLang=pt-br#main-content)
- [Treinamento - Conhecendo o nosso Dashboard](https://ajuda.d4sign.com.br/treinamento?hsLang=pt-br#treinamento-conhecendo-o-nosso-dashboard)
- [Treinamento - Enviando um documento para assinatura](https://ajuda.d4sign.com.br/treinamento?hsLang=pt-br#treinamento-enviando-um-documento-para-assinatura)
- [Treinamento - Opções do cofre](https://ajuda.d4sign.com.br/treinamento?hsLang=pt-br#treinamento-op%C3%A7%C3%B5es-do-cofre)
- [Treinamento - Pontos de autenticação](https://ajuda.d4sign.com.br/treinamento?hsLang=pt-br#treinamento-pontos-de-autentica%C3%A7%C3%A3o)
- [Treinamento - D4Sign.AI](https://ajuda.d4sign.com.br/treinamento?hsLang=pt-br#treinamento-d4sign-ai)
- [Treinamento - Menu Relatórios](https://ajuda.d4sign.com.br/treinamento?hsLang=pt-br#treinamento-menu-relat%C3%B3rios)
- [Treinamento - Template Word e Banco de Minutas](https://ajuda.d4sign.com.br/treinamento?hsLang=pt-br#treinamento-template-word-e-banco-de-minutas)
- [Treinamento - Power Form e Novo Power Form](https://ajuda.d4sign.com.br/treinamento?hsLang=pt-br#treinamento-power-form-e-novo-power-form)
- [Treinamento - Envio em lote e Grupos de assinaturas](https://ajuda.d4sign.com.br/treinamento?hsLang=pt-br#treinamento-envio-em-lote-e-grupos-de-assinaturas)
- [Primeiros Passos](https://ajuda.d4sign.com.br/primeiros-passos?hsLang=pt-br)
- [Dashboard](https://ajuda.d4sign.com.br/dashboard?hsLang=pt-br#main-content)
- [Caixa de Entrada](https://ajuda.d4sign.com.br/dashboard?hsLang=pt-br#caixa-de-entrada)
- [D4Sign CLM](https://ajuda.d4sign.com.br/dashboard?hsLang=pt-br#d4sign-clm)
- [Grupo de Assinatura](https://ajuda.d4sign.com.br/dashboard?hsLang=pt-br#grupo-de-assinatura)
- [Envio em Lote](https://ajuda.d4sign.com.br/dashboard?hsLang=pt-br#envio-em-lote)
- [Relatórios](https://ajuda.d4sign.com.br/dashboard?hsLang=pt-br#relat%C3%B3rios)
- [Últimos eventos do cofre](https://ajuda.d4sign.com.br/dashboard?hsLang=pt-br#%C3%BAltimos-eventos-do-cofre)
- [Menu Superior (Seu e-mail)](https://ajuda.d4sign.com.br/menu-superior-seu-e-mail?hsLang=pt-br#main-content)
- [Editar assinatura](https://ajuda.d4sign.com.br/menu-superior-seu-e-mail?hsLang=pt-br#editar-assinatura)
- [Faturamentos](https://ajuda.d4sign.com.br/menu-superior-seu-e-mail?hsLang=pt-br#faturamentos)
- [Certificados A1](https://ajuda.d4sign.com.br/menu-superior-seu-e-mail?hsLang=pt-br#certificados-a1)
- [Minha Conta](https://ajuda.d4sign.com.br/menu-superior-seu-e-mail?hsLang=pt-br#minha-conta)
- [Usuários do Domínio](https://ajuda.d4sign.com.br/menu-superior-seu-e-mail?hsLang=pt-br#usu%C3%A1rios-do-dom%C3%ADnio)
- [Notificações](https://ajuda.d4sign.com.br/menu-superior-seu-e-mail?hsLang=pt-br#notifica%C3%A7%C3%B5es)
- [Cadastro de SSO](https://ajuda.d4sign.com.br/menu-superior-seu-e-mail?hsLang=pt-br#cadastro-de-sso)
- [\ Dev (API)](https://ajuda.d4sign.com.br/menu-superior-seu-e-mail?hsLang=pt-br#dev-api)
- [Upgrade de conta](https://ajuda.d4sign.com.br/menu-superior-seu-e-mail?hsLang=pt-br#upgrade-de-conta)
- [GoPaperless - Selo de empresa sustentável](https://ajuda.d4sign.com.br/menu-superior-seu-e-mail?hsLang=pt-br#gopaperless-selo-de-empresa-sustent%C3%A1vel)
- [Cofres](https://ajuda.d4sign.com.br/cofres?hsLang=pt-br#main-content)
- [Novo Documento](https://ajuda.d4sign.com.br/cofres?hsLang=pt-br#novo-documento)
- [Opções do Cofre](https://ajuda.d4sign.com.br/cofres?hsLang=pt-br#op%C3%A7%C3%B5es-do-cofre)
- [Opções do cofre - Pré-cadastrar e-mails](https://ajuda.d4sign.com.br/cofres?hsLang=pt-br#op%C3%A7%C3%B5es-do-cofre-pr%C3%A9-cadastrar-e-mails)
- [Opções do cofre - Configurações](https://ajuda.d4sign.com.br/cofres?hsLang=pt-br#op%C3%A7%C3%B5es-do-cofre-configura%C3%A7%C3%B5es)
- [Opções do Cofre - Configurações - Permissões do Cofre](https://ajuda.d4sign.com.br/cofres?hsLang=pt-br#op%C3%A7%C3%B5es-do-cofre-configura%C3%A7%C3%B5es-permiss%C3%B5es-do-cofre)
- [Mover para outro cofre](https://ajuda.d4sign.com.br/cofres?hsLang=pt-br#mover-para-outro-cofre)
- [Como Assinar](https://ajuda.d4sign.com.br/como-assinar?hsLang=pt-br)
- [Integrações Via API e SSO](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#main-content)
- [Introdução a API](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#introdu%C3%A7%C3%A3o-a-api)
- [Endpoints Cofres](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#endpoints-cofres)
- [Endpoints Documentos](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#endpoints-documentos)
- [Endpoints Signatários](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#endpoints-signat%C3%A1rios)
- [Endpoints Adicionar Rubrica](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#endpoints-adicionar-rubrica)
- [Endpoints Observadores](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#endpoints-observadores)
- [Endpoints Certificados ICP-Brasil](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#endpoints-certificados-icp-brasil)
- [Endpoints Webhook](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#endpoints-webhook)
- [Endpoints Tags](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#endpoints-tags)
- [Endpoints Usuários](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#endpoints-usu%C3%A1rios)
- [Embed](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#embed)
- [SSO](https://ajuda.d4sign.com.br/integra%C3%A7%C3%B5es-via-api-e-sso?hsLang=pt-br#sso)
- [Perguntas Frequentes](https://ajuda.d4sign.com.br/perguntas-frequentes?hsLang=pt-br#main-content)
- [Contatos D4Sign](https://ajuda.d4sign.com.br/perguntas-frequentes?hsLang=pt-br#contatos-d4sign)
- [Procedimentos em Destaque](https://ajuda.d4sign.com.br/perguntas-frequentes?hsLang=pt-br#procedimentos-em-destaque)
- [Perguntas Frequentes](https://ajuda.d4sign.com.br/perguntas-frequentes?hsLang=pt-br#perguntas-frequentes)
- [Resolução de Problemas](https://ajuda.d4sign.com.br/perguntas-frequentes?hsLang=pt-br#resolu%C3%A7%C3%A3o-de-problemas)
- [Plano e Limites](https://ajuda.d4sign.com.br/perguntas-frequentes?hsLang=pt-br#plano-e-limites)
- [Segurança e Validade Jurídica](https://ajuda.d4sign.com.br/seguran%C3%A7a-e-validade-jur%C3%ADdica?hsLang=pt-br)
[](https://d4sign.com.br/)