2.10 Renovar suscripción SSL

2.10.1 Información de la API

Entorno de pruebas
Entorno real	https://portal.racent.com/ssl/renew
Método de solicitud	POST
content-type	multipart/form-data
Descripción	Esta interfaz se utiliza para renovar suscripciones SSL. Solo se permite renovar cuando el estado de la suscripción SSL es "emitido" y la suscripción expirará dentro de 30 días.

2.10.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.
renewId	String	Y	ID del certificado racent
years	Int	Y	Años de renovación (actualmente solo se admiten 1, 2, 3, 4, 5), según el producto específico.
refId	String	N	Número de orden único del cliente proporcionado por el cliente
verificationPic	File	N	Material de verificación de respaldo. Se utiliza para la verificación de la organización, admite formatos .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf, el contenido no debe superar 2M.
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 del pedido, descrita a continuación
csr	String	N	Si el parámetro está vacío, se generará un CSR por usted y se guardará la clave privada.
privateKey	String	N	Clave privada.
server	String	N	Servidor. Solo está relacionado con certificados SSL. Para certificados SSL el parámetro es Y; para otros tipos de productos es N. Si no necesita este parámetro, utilice “other” de forma predeterminada.
orgCheck	Int	N	El valor es 0 o 1. Cuando el valor es 1, se buscarán todas las organizaciones de su cuenta según la información de organización que envíe. Si existe, se utilizará la información asociada de la organización existente; si no existe, la guardaremos como una nueva organización. Cuando el valor es 0, no se guardará la información de la organización.
duplicateOrgCheck	Int	N	El valor es 0 o 1. Actualmente, este parámetro solo está relacionado con los certificados SSL de Digicert. Se utiliza para determinar si reutilizar la información de organización y dominio previamente verificada. Cuando el valor es 1, se reutiliza. Cuando el valor es 0, se crea una nueva. El valor predeterminado es 1.
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 forma 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 por 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	N	Información del dominio, solo relacionada con certificados SSL. Para certificados SSL el parámetro es Y, para otros tipos es N. Para CFCA este campo es N. 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" } ] La descripción detallada es la siguiente:
dcvMethod	String	N	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)
dcvEmail	String	N	Correo electrónico de validación del dominio. Si el método de validación es EMAIL, este campo es obligatorio (Y).
domainName	String	N	Nombre de dominio
organizationInfo	String	N	Información de la empresa. Cuando se solicita un producto que requiere verificación empresarial, este parámetro es Y. Para CFCA, este elemento es N. Ejemplo: { "organizationCity": "Shanghái", "organizationName": "Cierta empresa", "organizationMobile": "18111111111", "organizationAddress": "Calle de Shanghái", "organizationCountry": "CN", "organizationPostCode": "401320" }"
organizationCity	String	N	Ciudad donde se encuentra 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 donde se encuentra la empresa (código de dos letras según la norma ISO 3166-1).
organizationPostCode	String	N	Código postal de la ubicación de la empresa.
Administrator	String	Y	Información del administrador y persona de contacto. Al solicitar firma de código, firma de correo electrónico o firma de documentos, este parámetro se utiliza como información de la solicitud. Además, si csr es N, esta información se utiliza como información de generación del csr. Para CFCA, este elemento es N. { "job": "总经办", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
job	String	Y	Cargo del administrador.
city	String	Y	Ciudad donde se encuentra el administrador.
email	String	Y	Correo electrónico del administrador.
state	String	Y	Provincia o estado del administrador.
mobile	String	Y	Número de contacto del administrador.
address	String	Y	Dirección de contacto del administrador.
country	String	Y	País del administrador (código de dos letras según la norma ISO 3166-1).
lastName	String	Y	Apellido del administrador.
postCode	String	Y	Código postal del lugar del administrador.
firstName	String	Y	Nombre del administrador.
organation	String	Y	Nombre de la empresa del administrador.
finance	String		Solo relacionado con certificados SSL. Información del personal financiero. Puede ser igual a la información del administrador. Cuando el producto pedido no es de tipo DV, este parámetro es Y. Para CFCA este elemento es N. { "job": "Departamento Financiero", "city": "Shanghái", "email": "xx@yy.com", "state": "Shanghái", "mobile": "18111111111", "address": "Shanghái", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "cierta empresa" }"
job	String	N	Puesto del responsable de finanzas.
city	String	N	Ciudad donde se encuentra el responsable de finanzas.
email	String	N	Correo electrónico del responsable de finanzas.
state	String	N	Provincia o estado donde se encuentra el responsable financiero.
mobile	String	N	Información de contacto del responsable financiero.
address	String	N	Dirección de contacto del responsable financiero.
country	String	N	País del oficial de finanzas (código de dos letras según la norma ISO 3166-1).
lastName	String	N	Apellido del oficial de finanzas.
postCode	String	N	Código postal de la ubicación del oficial de finanzas.
firstName	String	N	Nombre del responsable financiero.
organation	String	N	Empresa del responsable financiero.
tech	String	N	Solo relacionado con certificados SSL. Información del técnico. Cuando el producto solicitado no es de tipo DV, este parámetro es Y. Para CFCA, este elemento es N. { "job": "Departamento técnico","city": "Shanghái", "email": "xx@yy.com", "state": "Shanghái", "mobile": "18111111111", "address": "Shanghái", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "Cierta empresa" }"
job	String	N	Puesto del técnico.
city	String	N	Ciudad donde se encuentra el técnico.
email	String	N	Correo electrónico del técnico.
state	String	N	Provincia o estado donde se encuentra el técnico.
mobile	String	N	Información de contacto del técnico.
address	String	N	Dirección de contacto del técnico.
country	String	N	País del técnico (código de dos letras según el estándar ISO 3166-1).
lastName	String	N	Apellido del técnico.
postCode	String	N	Código postal de la ubicación del técnico.
firstName	String	N	Nombre del técnico.
organation	String	N	Empresa del técnico.

Valor devuelto por la función

Nombre del parámetro	Tipo del parámetro	Obligatorio	Descripción
code	Int	Y	Estado devuelto; consulte el Apéndice 3.1 para más detalles.
errors	Object or String	N	Cuando el estado devuelto es un error, contiene el mensaje de error específico.
data	Object	N	Cuando el estado devuelto es correcto, este parámetro es Y. La descripción específica es la siguiente:
certId	String	N	ID del 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 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 validación por DNS
DCVdnsValue	String	N	Valor del registro para validación por DNS
DCVdnsType	String	N	Tipo de registro para validación por DNS
DCVfilePath	String	N	Ruta del archivo de validación por archivo
dcvInfo	Object	N	Cuando los valores de validación de cada dominio en la solicitud del certificado son diferentes, este campo es Y Cada elemento es de tipo Object, y el nombre de cada objeto es el dominio solicitado, por ejemplo: 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 validación por DNS
DCVdnsValue	String	N	Valor del registro para validación por DNS
DCVdnsType	String	N	Tipo de registro para validación por DNS
DCVfilePath	String	N	Ruta del archivo de validación por archivo