Errores

Los errores devuelven un código de estado HTTP y un mensaje de error. Los errores que provoque el cliente devuelven un código de estado 4xx Error del cliente. Los errores que provoque el servicio API devuelven un código de estado 5xx Error del servidor.

Ejemplo de respuesta de error

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

Parámetros de la respuesta

Nombre Tipo Descripción
errors array Lista de errores de la solicitud.
.. code string Código de error que identifica un error específico.
.. message string Descripción del error.

Códigos 4xx Error del cliente

Estado Código Descripción
429 request_limit_exceeded Servicio no disponible, limite el volumen de solicitudes.
Vea Límites de frecuencia
404 not_found Mensaje 404 genérico. Vele por que la URL del terminal esté formada correctamente.
404 not_found|pedido No se halló el pedido dado.
Vele por controlar lo siguiente:
  • La Id. del pedido de certificado SSL/TLS es correcta.
  • Se ha transferido el certificado SSL/TLS a su cuenta de CertCentral.
Para obtener más información, consulte Lo que debe saber sobre la transferencia de dominios y certificados.
404 not_found|producto No se encontró el producto especificado. Asegúrese de estar utilizando el identificador de producto correcto.
Vea Glosario: identificadores de productos
404 not_found|ruta El terminal no existe. Vele por que la URL del terminal que use sea correcta.
403 access_denied|missing_permission La clave API que está utilizando no tiene permisos para realizar la solicitud. Envíe una solicitud GET al terminal /user/me y halle el valor access_roles.name para determinar el nivel de autorización de la clave.
400 ambiguous_product El valor product.type_hint no se pudo utilizar para determinar el producto.
Vea Enviar pedido: cuadro de parámetros de la solicitud
400 auth_key_exists_for_account Ya se ha creado una AuthKey para su cuenta.
400 bad_request_format El cuerpo de la solicitud está mal formado. Asegúrese de que el cuerpo de la solicitud utilice JSON o XML válidos.
400 cert_transparency_turned_off_for_account Se ha desactivado el registro CT para su cuenta de CertCentral. Un administrador debe activar esta función.
400 csr_invalid_cannot_parse La CRS no tiene el formato correcto, faltan los campos obligatorios o contiene campos con caracteres no válidos.
Vea Crear una CSR
400 csr_not_allowed El producto especificado no utiliza una CSR.
Vea Glosario: requisitos de la CSR
400 ct_logging_disabled Se ha desactivado el registro CT para su cuenta de CertCentral. Un administrador debe activar esta función.
400 custom_expiration_not_allowed Los períodos de validez permitidos están configurados para el tipo de producto. Elimine las restricciones para permitir personalizar las fechas de vencimiento.
400 disabled_domain El dominio enviado está desactivado. Debe activar el dominio antes de enviarlo.
Vea Activar dominio
400 domain_not_allowed Las restricciones del dominio están configuradas para el contenedor especificado.
400 email_domain_not_validated El correo electrónico debe tener un dominio validado.
400 email_not_valid_email_format La dirección de correo electrónico enviada no es válida. Asegúrese de que la dirección de correo electrónico enviada siga las convenciones estándares de una dirección de correo electrónico.
400 file_random_value_not_found No se pudo hallar el valor aleatorio en la ubicación del archivo esperada para el dominio.
Vele por controlar lo siguiente:
  • el nombre del archivo .txt es fileauth.txt.
  • Ubicó el archivo fileauth.txt en .well-known/pki-validation/.
    Ejemplo de URL: http://[sudominio]/.well-known/pki-validation/fileauth.txt
  • El valor aleatorio en el archivo fileauth.txt es igual al valor aleatorio provisto por DigiCert.
Para obtener más información, consulte:
400 inactive_organization La organización enviada está desactivada. Active la organización o especifique una organización diferente.
Vea Activar organización
400 internal_names_not_allowed
400 invalid_ca_cert_id La Autoridad de Certificados especificada no es válida.
400 invalid_chars:<param.name> El parámetro especificado contiene caracteres no válidos. Consulte el cuadro de parámetros de Respuesta del terminal para conocer los caracteres de entrada válidos.
400 invalid_common_name_on_duplicate El nombre común de las solicitudes duplicadas debe coincidir con lo que figura en el pedido original. Consulte el pedido original para conocer el nombre común correcto.
400 invalid_dns_cname No se puede hallar un registro DNS CNAME válido para el dominio.
Vele por controlar lo siguiente:
  • Se han aplicado los cambios en el registro DNS CNAME.
  • El valor aleatorio en el registro CNAME es igual al valor aleatorio provisto por DigiCert.
  • El campo Alojamiento de destino (o equivalente) está establecido en dcv.digicert.com.
Para obtener más información, consulte Usar el registro DNS CNAME para demostrar el control del dominio.
400 invalid_dns_method El método DCV para el pedido está configurado para correo electrónico.
400 invalid_dns_name_on_duplicate El nombre DNS de las solicitudes duplicadas debe coincidir con lo que figura en el pedido original. Consulte el pedido original para conocer el nombre DNS correcto.
400 invalid_dns_txt No se puede hallar un registro DNS TXT válido para el dominio.
Vele por controlar lo siguiente:
  • Se han aplicado los cambios en el registro DNS TXT.
  • El valor aleatorio en el registro TXT es igual al valor aleatorio provisto por DigiCert.
Para obtener más información, consulte Usar el registro DNS TXT para demostrar el control del dominio.
400 invalid_payment_method El método de pago especificado no está habilitado. Para utilizar la solicitud de pago especificado, debe habilitarlo en su cuenta.
400 invalid_value:<param.name> El parámetro especificado contiene un valor no válido. Consulte el cuadro de parámetros de Respuesta del terminal para conocer los valores de entrada válidos.
400 missing_ca_cert_id Se necesita la Id. de la autoridad de certificados para esta solicitud. Especifique la autoridad de certificados que emitirá el certificado y reenvíe su solicitud.
400 missing_dns_name_on_duplicate Falta el nombre DNS en la solicitud. Los nombres DNS no pueden eliminarse de los pedidos duplicados. Reenvíe la solicitud con el nombre DNS incluido.
400 missing_request_data No se ha enviado ningún cuerpo con la solicitud. Consulte la documentación del terminal para conocer los requisitos de la solicitud.
400 missing_required_custom_field Al cuerpo de la solicitud le falta un campo personalizado obligatorio.
Para obtener una lista de los metadatos personalizados obligatorios del pedido para su cuenta, vea Lista de campos personalizados.
400 no_private_ca_enabled No hay autoridades de certificados privadas habilitadas para la cuenta.
400 not_allowed_to_change_ct_setting_per_order La función según el pedido del certificado no se ha activado en su cuenta de CertCentral. Un administrador debe activar esta función.
400 order_not_eligible_for_duplicate No se permiten duplicados para el pedido especificado.
400 other_domain_on_wildcard Todos los SAN de un certificado comodín deben tener el mismo nombre común. Cambie los SAN para utilizar el mismo nombre común o pida un certificado de varios dominios.
400 pending_reissue Aún hay una solicitud de reemisión previa pendiente para el pedido. Debe rechazar o aprobar y emitir la solicitud pendiente antes de colocar una nueva solicitud de reemisión.
400 product_name_limit_exceeded Ha superado la cantidad de nombres permitidos en este producto.
400 product_not_allowed Este producto no está permitido.
400 protected_domain Uno o más dominios mencionados en esta solicitud de certificado están protegidos por el titular del dominio. Modifique los dominios y vuelva a enviar la solicitud.
400 required_param: El parámetro especificado es obligatorio. Consulte el cuadro de parámetros de Respuesta del terminal para determinar los parámetros obligatorios y los opcionales.
400 rfc5280_common_name_invalid El nombre común enviado no cumple con los estándares de la industria.
400 rfc5280_common_name_too_long El nombre común debe tener menos de 64 caracteres para cumplir con los estándares de la industria.
400 rfc5280_org_unit_too_long Las unidades de la organización deben tener menos de 64 caracteres para cumplir con los estándares de la industria.
400 rfc5280_org_name_too_long La longitud total del nombre de la organización (incluido el nombre asumido para los certificados EV) debe tener menos de 64 caracteres para cumplir con los estándares de la industria.
400 rfc5280_address_field_too_long Los cambios dirección deben tener menos de 64 caracteres para cumplir con los estándares de la industria.
400 rfc5280_org_unit_invalid El campo unidad de organización contiene un valor no válido de acuerdo con las normas del sector.
400 rfc5280_org_invalid Uno o más campos de la organización tienen valores no válidos de acuerdo con los estándares de la industria.
400 username_unavailable El nombre de usuario especificado no está disponible.