2.12 Reemplazar información de suscripción SSL

2.12.1 Información de la API

Entorno de pruebas
Entorno real	https://portal.racent.com/ssl/replace
Método de solicitud	POST
content-type	multipart/form-data
Descripción	Esta API se utiliza para reemplazar la información de suscripción SSL. Solo está relacionada con certificados SSL. Solo se permite reemplazar la información de suscripción SSL cuando el estado de la suscripción SSL es "Emitido".

2.12.2 Definición de parámetros

Nombre del parámetro	Tipo de parámetro	Obligatorio	Descripción
api_token	String	Y	Credencial de identidad. Para generar el token, contacte al soporte técnico de Racent.
certId	String	Y	ID de certificado de Racent
refId	String	N	Número de pedido único del cliente proporcionado por el cliente
domainVerificationPic	File	N	Cuando el método de verificación del dominio es: VERIFY_DOCUMENT, este campo es Y. Se utiliza para la verificación de la propiedad del dominio (actualmente solo compatible con CFCA).
params	String	Y	Información de reemplazo, descrita a continuación
csr	String	Y	Nota: El dominio en la información CSR debe ser coherente con el dominio en el CSR de la suscripción SSL original.
uniqueValue	String	N	Solo relacionado con productos Sectigo. De 1 a 20 caracteres (a-z A-Z 0-9) para que el distribuidor genere de forma autónoma el valor de verificación.
dcvMethod	String	N	Configura de manera unificada el método de verificación del dominio solicitado. Debe ser uno de los siguientes cuatro métodos: EMAIL (verificación por correo electrónico) HTTP_CSR_HASH (verificación por archivo) CNAME_CSR_HASH (verificación DNS) HTTPS_CSR_HASH (verificación por archivo https) VERIFY_DOCUMENT (prueba de certificado de dominio, solo compatible con CFCA) Para CFCA este campo es Y
domainInfo	String	Y	Información del dominio. Ejemplo: [ { "dcvEmail": "admin@xxx.com", "dcvMethod": "EMAIL", "domainName": "www.xxx.com" }, { "dcvEmail": "admin@aaa.com", "dcvMethod": "EMAIL", "domainName": "aaa.com" }, "dcvEmail": "admin@racent.com", "dcvMethod": "EMAIL", "domainName": "racent.com" } ] Descripción detallada a continuación:
dcvMethod	String	Y	Método de validación del dominio. Debe ser uno de los cuatro métodos siguientes: EMAIL (validación por correo electrónico) HTTP_CSR_HASH (validación por archivo) CNAME_CSR_HASH (validación DNS) HTTPS_CSR_HASH (validación por archivo https) Cuando el dcvMethod del nivel superior no existe, este campo es Y. Cuando el dcvMethod del nivel superior existe y este campo también existe, se priorizará el dcvMethod del nivel superior.
dcvEmail	String	N	Correo electrónico de validación del dominio. Cuando este campo es N, los valores predeterminados son los siguientes: racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com
domainName	String	Y	Dominio
organizationInfo	String	N	Cuando necesite cambiar la información de la empresa, este parámetro es Y.
organizationCity	String	N	Ciudad de la empresa.
organizationName	String	N	Nombre de la empresa.
organizationMobile	String	N	Teléfono de la empresa.
organizationAddress	String	N	Dirección de la empresa.
organizationCountry	String	N	País de la empresa (código de dos letras según la norma ISO 3166-1).
organizationPostCode	String	N	Código postal de la empresa.

Retorno de la función

Nombre del parámetro	Tipo de parámetro	Requerido	Descripción
code	Int	Y	Estado de retorno; para más detalles, consulte el Apéndice 3.1
errors	Object o String	N	Cuando el estado de retorno es un error, contiene la información específica del error.
data	Object	N	Cuando el estado de retorno es correcto, este parámetro es Y. La descripción específica es la siguiente:
certId	String	N	ID de certificado racent. Consérvelo adecuadamente; este parámetro es la credencial única de la instancia racent.
vendorId	String	N	Número de pedido de la CA.
vendorCertId	String	N	Número de certificado de la CA.
DCVfileName	String	N	Nombre de archivo para la validación por archivo
DCVfileContent	String	N	Contenido del archivo para la validación por archivo
DCVdnsHost	String	N	Valor del host para la validación DNS
DCVdnsValue	String	N	Valor del registro para la validación DNS
DCVdnsType	String	N	Tipo de registro para la validación DNS
DCVfilePath	String	N	Ruta del archivo para la validación por archivo
dcvInfo	Object	N	Cuando los valores de validación de cada dominio en la solicitud de certificado son diferentes, este campo es Y Cada elemento es de tipo Object, y el nombre de cada objeto es el dominio solicitado, p. ej.: racent.com. Los detalles de cada elemento son los siguientes:
DCVfileName	String	N	Contenido del archivo de validación por archivo
DCVfileContent	String	N	Contenido del archivo de validación por archivo
DCVdnsHost	String	N	Valor del host para la validación DNS
DCVdnsValue	String	N	Valor del registro para la validación DNS
DCVdnsType	String	N	Tipo de registro para la validación DNS
DCVfilePath	String	N	Ruta del archivo de validación por archivo