Erros

Erros retornam um código de status HTTP e uma mensagem de erro. Erros causados pelo cliente retornam um código de status 4xx Client Error. Erros causados pelo serviço de API retornam um código de status 5xx Server Error.

Resposta de exemplo de exemplo

json
{
  "errors": [
    {
      "code": "<error_code>",
      "message": "<error_message>"
    }
  ]
}

Parâmetros da resposta

Nome Tipo Descrição
errors array Lista de erros da solicitação.
.. code string Código de erro identificando um erro específico.
.. message string Descrição do erro.

Códigos de Erro 4xx Client

Status Código Descrição
429 request_limit_exceeded Serviço indisponível, limite o volume de solicitações.
Veja Limites de taxa
404 not_found Mensagem genérica 404. Certifique-se de que a URL do ponto de extremidade esteja construída adequadamente.
404 not_found|pedido O pedido especificado não foi encontrado.
Certifique-se de que:
  • A ID do certificado SSL/TLS está correta.
  • O certificado SSL/TLS foi migrado para a sua conta da CertCentral.
Para mais informações, veja O que você precisa saber sobre migração de domínios e certificados.
404 not_found|produto O produto especificado não foi encontrado. Certifique-se de estar usando o identificador correto do produto.
Veja Glossário — Identificadores de produtos
404 not_found|rota O ponto de extremidade não existe. Certifique-se de que a URL do ponto de extremidade está correta.
403 access_denied|missing_permission A chave de API que você está usando não tem permissão para realizar a solicitação. Envie uma solicitação GET ao ponto de extremidade /user/me e encontre o valor access_roles.name para identificar o nível de autorização da chave.
400 ambiguous_product O valor product.type_hint não pode ser usado para determinar um produto.
Veja Enviar pedido — Tabela de parâmetros da solicitação
400 auth_key_exists_for_account Uma AuthKey já foi criada para a sua conta.
400 bad_request_format O corpo da solicitação está malformado. Certifique-se de que o corpo da solicitação usa JSON ou XML válido.
400 cert_transparency_turned_off_for_account Registro CT foi desativado para esta conta da CertCentral. Um administrador deve habilitar este recurso.
400 csr_invalid_cannot_parse O CSR não está no formato correto, está faltando campos obrigatórios ou possui campos com caracteres inválidos.
Veja Criar um CSR
400 csr_not_allowed O produto especificado não usa um CSR.
Veja Glossário — Requisitos de CSR
400 ct_logging_disabled Registro CT foi desativado para esta conta da CertCentral. Um administrador deve habilitar este recurso.
400 custom_expiration_not_allowed Períodos de validade permitidos estão configurados para o tipo de produto. Remova as restrições para permitir datas personalizadas de validade.
400 disabled_domain O domínio enviado está desativado. Você deve ativar o domínio antes de enviá-lo.
Veja Ativar domínio
400 domain_not_allowed Restrições de domínio estão configuradas para o recipiente especificado.
400 email_domain_not_validated O e-mail deve ter um domínio validado.
400 email_not_valid_email_format O endereço de e-mail enviado não é válido. Certifique-se de que o endereço de e-mail enviado segue as convenções padrão de endereço de e-mail.
400 file_random_value_not_found Não é possível encontrar o valor aleatório na localização do arquivo para o domínio.
Certifique-se de que:
  • nome do arquivo .txt é fileauth.txt.
  • arquivo fileauth.txt foi feito sob .well-known/pki-validation/
    URL de exemplo: http://[yourdomain]/.well-known/pki-validation/fileauth.txt
  • Valor aleatório no arquivo fileauth.txt corresponde ao valor aleatório fornecido da DigiCert.
Para mais informações:
400 inactive_organization A organização enviada está desativada. Ative a organização ou especifique uma organização diferente.
Veja Ativar organização
400 internal_names_not_allowed
400 invalid_ca_cert_id A Autoridade de Certificação especificada não é válida.
400 invalid_chars:<param.name> O parâmetro especificado possui caracteres inválidos. Consulte a tabela de parâmetros de Resposta do ponto de extremidade para caracteres válidos de entrada.
400 invalid_common_name_on_duplicate O nome comum em solicitações de duplicata deve corresponder ao que estava no pedido original. Consulte o pedido original para o nome comum correto.
400 invalid_dns_cname Incapaz de encontrar um registro DNS CNAME para o domínio.
Certifique-se de que:
  • Alterações do registro DNS CNAME estão ativas.
  • Valor aleatório no registro CNAME corresponde ao valor aleatório fornecido da DigiCert.
  • Campo de host de destino (ou equivalente) está definido para dcv.digicert.com.
Para mais informações, veja Usar registro CNAME de DNS para demonstrar controle sobre o domínio.
400 invalid_dns_method O método DCV para o pedido está definido para e-mail.
400 invalid_dns_name_on_duplicate O nome DNS em solicitações de duplicata deve corresponder ao que estava no pedido original. Consulte o pedido original para o nome DNS correto.
400 invalid_dns_txt Incapaz de encontrar um registro DNS TXT para o domínio.
Certifique-se de que:
  • Alterações do registro DNS TXT estão ativas.
  • Valor aleatório no registro TXT corresponde ao valor aleatório fornecido da DigiCert.
Para mais informações, veja Usar registro DNS TXT para demonstrar controle sobre o domínio
400 invalid_payment_method O método de pagamento especificado não está habilitado. Para usar a solicitação especificada de pagamento, é necessário habilitá-la na sua conta.
400 invalid_value:<param.name> O parâmetro especificado possui um valor inválido. Consulte a tabela de parâmetros de Resposta do ponto de extremidade para valores válidos de entrada.
400 missing_ca_cert_id A ID da autoridade de certificação é obrigatória para esta solicitação. Especifique a autoridade de certificação para emitir o certificado e reenvie sua solicitação.
400 missing_dns_name_on_duplicate O nome DNS está ausente na solicitação. Nomes DNS não podem ser removidos em pedidos de duplicatas. Reenvie a solicitação com o nome DNS incluso.
400 missing_request_data Nenhum corpo foi enviado com a solicitação. Consulte a documentação do ponto de extremidade para os requisitos da solicitação.
400 missing_required_custom_field O corpo da solicitação não tem um campo personalizado obrigatório.
Para obter uma lista dos metadados do campo personalizado do pedido para a sua conta, veja Campos personalizados da lista.
400 no_private_ca_enabled Nenhuma autoridade de certificação está habilitada a conta.
400 not_allowed_to_change_ct_setting_per_order O recurso de pedido por certificado não foi ativado para a sua conta da CertCentral. Um administrador deve habilitar este recurso.
400 order_not_eligible_for_duplicate Duplicatas não são permitidas para o pedido especificado.
400 other_domain_on_wildcard Todos os SANs em um certificado curinga devem ter o mesmo nome comum. Altere os SANs para usar o mesmo nome comum ou peça um certificado de múltiplos domínios.
400 pending_reissue Uma solicitação anterior de reemissão ainda está pendente para o pedido. Você deve rejeitar ou aprovar e emitir a solicitação pendente antes que uma nova solicitação de reemissão possa ser feita.
400 product_name_limit_exceeded Você excedeu o número de nomes permitidos neste produto.
400 product_not_allowed Este produto não é permitido.
400 protected_domain Um ou mais domínios listados nesta solicitação de certificado estão protegidos pelo dono do domínio. Modifique os domínios e reenvie a solicitação.
400 required_param: O parâmetro especificado é necessário Consulte a tabela de parâmetros de Respostas do ponto de extremidade para identificar parâmetros obrigatórios e opcionais.
400 rfc5280_common_name_invalid O nome comum enviado não está em conformidade com os padrões da indústria.
400 rfc5280_common_name_too_long Nome comum deve ser menor que 64 caracteres para estar em conformidade com as normas da indústria.
400 rfc5280_org_unit_too_long Unidades da organização devem ser menores que 64 caracteres para estarem em conformidade com as normas da indústria.
400 rfc5280_org_name_too_long O comprimento total do nome da organização (incluindo Nome presumido para certificados EV) deve ser menor que 64 caracteres para estar em conformidade com as normas da indústria.
400 rfc5280_address_field_too_long Campos de endereço devem ser menores que 64 caracteres para estarem em conformidade com as normas da indústria.
400 rfc5280_org_unit_invalid O campo de unidade org possui um valor inválido de acordo com as normas da indústria.
400 rfc5280_org_invalid Um ou mais campos na organização possui valores inválidos de acordo com as normas da indústria.
400 username_unavailable O nome de usuário especificado não está disponível.