2.3 Obtener el estado de la solicitud del certificado

2.3.1 Información de la API

Entorno de pruebas
Entorno real	https://portal.racent.com/ssl/collect
Método de solicitud	POST
content-type	multipart/form-data
Descripción	Esta interfaz se utiliza para obtener el estado del pedido del certificado, obtener el certificado y obtener la información de validación.

2.3.2 Definición de parámetros

Nombre del parámetro	Tipo de parámetro	Obligatorio	Descripción
certId	String	Y	ID de certificado de racent
api_token	String	Y	Credencial de identidad; para generar el token, contacte con el soporte técnico de Racent.

Retorno de la función

Nombre del parámetro	Tipo de parámetro	Obligatorio	Descripción
code	int	Y	Estado de retorno; para más detalles, consulte el Apéndice 3.1
status	String	Y	Estado del pedido: PENDING: en solicitud COMPLETE: solicitud exitosa CANCELLED: cancelado REISSUED: reemitido FAILED: solicitud fallida RENEWED: renovado REVOKED: revocado
certStatus	String	Y	Estado del certificado: PENDING: en solicitud COMPLETE: solicitud exitosa CANCELLED: cancelado REISSUED: reemitido FAILED: solicitud fallida RENEWED: renovado REVOKED: revocado
data	Object	N	Datos devueltos, los siguientes son los detalles específicos
failReason	Object	N	Cuando el estado es FAILED, este parámetro es Y, motivo del fallo
dataReasons	Array	N	Motivos de los datos
key	String	N	Elemento
reason	String	N	Motivo
sysReason	String	N	Motivo del sistema
beginDate	String	N	Cuando el estado es COMPLETE, este parámetro es Y, hora de inicio del certificado
endDate	String	N	Cuando el estado es COMPLETE, este parámetro es Y, hora de finalización del certificado
certificate	String	N	Cuando el estado es COMPLETE, este parámetro es Y, certificado pem
caCertificate	String	N	Cuando el estado es COMPLETE, este parámetro es Y, certificado intermedio en formato pem
jks	String	N	Cuando el estado es COMPLETE y Racent tiene la información correcta de la clave privada, este parámetro es Y, contenido del certificado JKS codificado en base64.
jksPass	String	N	Cuando el estado es COMPLETE y Racent tiene la información correcta de la clave privada, este parámetro es Y, contraseña del certificado JKS.
pkcs12	String	N	Cuando el estado es COMPLETE y Racent tiene la información correcta de la clave privada, este parámetro es Y, contenido del certificado PKCS12 codificado en base64.
pkcsPass	String	N	Cuando el estado es COMPLETE y Racent tiene la información correcta de la clave privada, este parámetro es Y, contraseña del certificado PKCS12.
privateKey	String	N	Cuando el estado es COMPLETE y Racent tiene la información correcta de la clave privada, este parámetro es Y, información de la clave privada
rsaPrivateKey	String	N	Clave privada en formato RSA. Cuando el estado es COMPLETE y Racent tiene la información correcta de la clave privada, este parámetro es Y, información de la clave privada
replaceCertId	String	N	Cuando el estado es REISSUED, este parámetro es Y, ID del certificado sslTrus después de la reemisión
oldCertId	String	N	Cuando el certificado solicitado es una reemisión, este parámetro es Y, ID del certificado sslTrus anterior
vendorId	String	N	Número de pedido de la CA
vendorCertId	String	N	Número de certificado de la CA (número de pedido de Sectigo)
DCVfileName	String	N	Validación por archivo de dominio, nombre del archivo
DCVfileContent	String	N	Validación por archivo, contenido del archivo
DCVdnsHost	String	N	Validación por DNS, host
DCVdnsValue	String	N	Validación por DNS, value
DCVdnsType	String	N	Validación por DNS, type
dcvInfo	Object	N	Cuando los valores de validación de cada dominio en la solicitud de certificado son diferentes, este elemento es Y Cada elemento es de tipo Object, y el nombre de cada objeto es el dominio solicitado, como: racent.com. Los detalles de cada elemento son los siguientes:
DCVfileName	String	N	Validación por archivo de dominio, nombre del archivo
DCVfileContent	String	N	Validación por archivo, contenido del archivo
DCVdnsHost	String	N	Validación DNS, host
DCVdnsValue	String	N	Validación DNS, value
DCVdnsType	String	N	Validación DNS, type
DCVfilePath	String	N	Ruta del archivo para validación por archivo
dcvList	Array	N	Lista de validación de dominios, cada elemento es de tipo Object, los detalles de cada elemento son los siguientes:
domainName	String	N	Nombre de dominio
dcvMethod	String	N	Método de validación del dominio
dcvEmail	String	N	Correo electrónico de validación del dominio
is_verify	String	N	El valor del parámetro verificado es "verified"; sin verificación no hay parámetro
application	Object	N	Estado de envío del pedido
status	String	N	El parámetro es uno de los siguientes valores: notdone: No completado done: Completado ongoing: En curso
dcv	Object	N	Estado de verificación del dominio
status	String	N	El parámetro es uno de los siguientes valores: notdone: No completado done: Completado ongoing: En curso
ov	Object	N	Estado de verificación de la organización
status	String	N	El parámetro es uno de los siguientes valores: notdone: No completado done: Completado ongoing: En curso
issued	Object	N	Estado de emisión
status	String	N	El parámetro es uno de los siguientes valores: notdone: No completado done: Completado ongoing: En curso
applyParams	Object	N	Parámetros de solicitud; para más detalles, consulte los parámetros de solicitud de la interfaz de solicitud (place)
csr	String	N	csr
Administrator	Object	N	Información del administrador
job	String	N	Cargo
city	String	N	Ciudad
email	String	N	Correo electrónico
state	String	N	Provincia o estado
mobile	String	N	Información de contacto
address	String	N	Dirección de contacto
country	String	N	País (código de dos letras según la norma ISO 3166-1).
lastName	String	N	Apellido
postCode	String	N	Código postal
firstName	String	N	Nombre
organation	String	N	Nombre de la empresa
idType	String	N	Tipo de documento. Para CFCA este campo es Y. Valores: SFZ: DNI HZ: Pasaporte
idNumber	String	N	Número de documento. Para CFCA este campo es Y.
tech	Object	N	Información del técnico; los campos son los mismos que los del administrador
finance	Object	N	Información del responsable financiero; los campos son los mismos que los del administrador
organizationInfo	Object	N	Información de la empresa
organizationCity	String	N	Ciudad
organizationName	String	N	Nombre
organizationMobile	String	N	Teléfono
organizationAddress	String	N	Dirección
organizationCountry	String	N	País
organizationPostCode	String	N	Código postal
organizationRegNumbe	String	N	Número de identificación de la empresa. Para CFCA, este campo es obligatorio (Y).
idType	String	N	Tipo de identificación de la empresa. Para CFCA, este campo es obligatorio (Y). Valores posibles: TYDMZ: Código unificado de crédito social OTHERS: Otro
errors	Object o String	N	Información específica del error cuando el estado devuelto indica un error.