2.21 Modificar datos de la solicitud

2.21.1 Información de la API

Entorno de prueba
Entorno real	https://portal.racent.com/ssl/alter
Método de solicitud	POST
content-type	multipart/form-data
Descripción	Esta interfaz solo se utiliza cuando falla la solicitud del certificado CFCA, para modificar la información de la solicitud.

2.21.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, comuníquese con el soporte técnico de Racent.
certId	String	Y	ID del certificado de Racent
refId	String	N	Número único de pedido del cliente proporcionado por el cliente
verificationPic	File	N	Material de verificación de respaldo. Se utiliza para la validación de la organización y admite los formatos .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip, con un tamaño máximo de 2M.
domainVerificationPic	File	N	Si el método de verificación del dominio es VERIFY_DOCUMENT, este campo es obligatorio (Y). Se utiliza para verificar la propiedad del dominio (actualmente solo es 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 y se guardará la clave privada.
privateKey	String	N	Clave privada.
server	String	N	Servidor. Solo relevante para certificados SSL. El parámetro del certificado SSL es Y, y para otros tipos de productos es N. Si no necesita este parámetro, use "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 tu cuenta según la información de organización enviada; 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 se reutiliza 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.
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 DNS) HTTPS_CSR_HASH (verificación por archivo HTTPS) VERIFY_DOCUMENT (prueba de certificado de dominio, solo compatible con CFCA) Para CFCA, este elemento 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. El total de dominios estándar y dominios comodín no puede exceder respectivamente el total de dominios estándar y dominios comodín adquiridos. 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 siguientes cuatro métodos: EMAIL (validación por correo electrónico) HTTP_CSR_HASH (validación por archivo) CNAME_CSR_HASH (validación por DNS) HTTPS_CSR_HASH (validación por archivo HTTPS) Cuando dcvMethod del nivel superior no existe, este campo es Y. Cuando dcvMethod del nivel superior existe y este campo también existe, se priorizará dcvMethod del nivel superior
dcvEmail	String	N	Correo electrónico para la validación del dominio. Cuando este campo es N, los valores por defecto son los siguientes: racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com
domainName	String	N	Nombre de dominio
organizationInfo	String	N	Información de la empresa. Cuando se solicitan productos que requieren validación empresarial, este parámetro es Y. 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.
organizationRegNumbe	String	N	Número de identificación de la empresa. Para CFCA, este campo es Y.
idType	String	N	Tipo de identificación de la empresa. Para CFCA, este campo es Y. Valores: TYDMZ: Código Unificado de Crédito Social OTHERS: Otros
Administrator	String	Y	Información del administrador y persona de contacto. Cuando se solicita firma de código, firma de correo 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 para generar el csr. { "job": "Oficina General", "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	Y	Puesto del administrador.
city	String	Y	Ciudad del administrador.
email	String	Y	Correo electrónico del administrador.
state	String	Y	Provincia o estado del administrador.
mobile	String	Y	Información 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 el estándar ISO 3166-1).
lastName	String	Y	Apellido del administrador.
postCode	String	Y	Código postal de la ubicación del administrador.
firstName	String	Y	Nombre del administrador.
organation	String	Y	Nombre de la empresa del administrador.
idType	String	N	Tipo de documento. Para CFCA, este campo es Y. Valores posibles: SFZ: Documento Nacional de Identidad HZ: Pasaporte
idNumber	String	N	Número de documento. Para CFCA, este campo es Y.
finance	String		Solo relacionado con certificados SSL. Información del personal financiero. Puede ser la misma que la información del administrador. Cuando el producto solicitado no es de tipo DV, este parámetro es Y. { "job": "财务部", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
job	String	N	Puesto del responsable financiero.
city	String	N	Ciudad donde se encuentra el responsable financiero.
email	String	N	Correo electrónico del responsable financiero.
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 responsable financiero (código de dos letras según la norma ISO 3166-1).
lastName	String	N	Apellido del responsable financiero.
postCode	String	N	Código postal de la ubicación del responsable financiero.
firstName	String	N	Nombre del responsable financiero.
organation	String	N	Empresa del responsable financiero.
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	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. { "job": "技术部","city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
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 la norma 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.
idType	String	N	Tipo de documento. Para CFCA este campo es Y. Valores posibles: SFZ: DNI HZ: Pasaporte
idNumber	String	N	Número de documento. Para CFCA este campo es Y.

Retorno de la funció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 devuelto es un error, información específica del error.
data	Object	N	Cuando el estado devuelto es exitoso, 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 verificación por archivo
DCVfileContent	String	N	Contenido del archivo de verificación por archivo
DCVdnsHost	String	N	Valor del host para verificación DNS
DCVdnsValue	String	N	Valor del registro para verificación DNS
DCVdnsType	String	N	Tipo de registro para verificación DNS
DCVfilePath	String	N	Ruta del archivo de verificación por archivo
dcvInfo	Object	N	Cuando los valores de verificación de cada dominio en la solicitud del certificado son diferentes, este elemento 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 verificación por archivo
DCVfileContent	String	N	Contenido del archivo de validación por archivo
DCVdnsHost	String	N	Valor del host de validación DNS
DCVdnsValue	String	N	Valor del registro de validación DNS
DCVdnsType	String	N	Tipo de registro de validación DNS
DCVfilePath	String	N	Ruta del archivo de validación por archivo
failReason	Object	N	Cuando Racent solicita el certificado a la CA y falla, y se puede identificar claramente el motivo del fallo, se devuelve este elemento.
dataReasons	Array	N	Motivos de datos
key	String	N	Elemento
reason	String	N	Motivo
sysReason	String	N	Motivo del sistema