2.2 Pedido de certificado

2.2.1 Descripción de la interfaz

Entorno de prueba
Entorno real	https://portal.racent.com/ssl/place
Método de solicitud	POST
content-type	multipart/form-data
Descripción	Esta interfaz se utiliza para solicitar certificados.

2.2.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.
productCode	String	Y	Código del producto, obtener el código del producto (ver 2.7)
years	Int	Y	Años de compra (actualmente solo se admiten 1, 2, 3, 4, 5), según el producto específico.
refId	String	N	Número de pedido único 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. Formatos admitidos: .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf, tamaño máximo 2 MB.
domainVerificationPic	File	N	Cuando el método de verificación del dominio es: VERIFY_DOCUMENT, este campo es obligatorio (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 en detalle a continuación
csr	String	N	Si el parámetro está vacío, se generará un CSR por ti y se guardará la clave privada.
privateKey	String	N	Clave privada.
server	String	N	Servidor. Solo relacionado con certificados SSL. El parámetro del certificado SSL es Y, y el parámetro de otros tipos de productos es N. Si no necesitas este parámetro, usa “other” por defecto.
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 una, 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. Este parámetro actualmente 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 validada. Cuando el valor es 1, se reutiliza. Cuando el valor es 0, se crea una nueva. El valor predeterminado es 1.
needFree	Int	N	El valor es 1 o 2. Cuando el valor es 1, se regalará el FQDN y, al mismo tiempo, www.dominio también regalará el dominio. Cuando el valor es 2, no se regala.
uniqueValue	String	N	Solo relevante para 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 de los dominios solicitados. Debe ser uno de los cuatro métodos siguientes: 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 (certificado de dominio, solo compatible con CFCA) Para CFCA, este valor es Y
domainInfo	String	N	Información del dominio, solo relevante para certificados SSL. Para los parámetros de certificados SSL es Y; para otros tipos de parámetros 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 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 el dcvMethod del nivel superior no existe, este campo es obligatorio (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	N	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": "上海", "organizationName": "某公司", "organizationMobile": "18111111111", "organizationAddress": "上海市路", "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 posibles: TYDMZ: Código unificado de crédito social OTHERS: Otros
Administrator	string	Y	Información del administrador y persona de contacto. Al solicitar 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": "总经办", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
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 la norma 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 de identidad. Para CFCA, este campo es Y.
idNumber	String	N	Número del documento de identidad. Para CFCA, este campo es Y.
finance	string		Solo relacionado con certificados SSL. Información del personal financiero. Puede ser la misma que la del administrador. Cuando el producto solicitado no es de tipo DV, este parámetro es Y. { "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 personal financiero.
city	String	N	Ciudad del responsable financiero.
email	String	N	Correo electrónico del responsable financiero.
state	String	N	Provincia o estado del 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 de la persona encargada de finanzas.
idType	String	N	Tipo de documento. Para CFCA, este campo es Y. Valores: SFZ: Documento de identidad HZ: Pasaporte
idNumber	String	N	Número del 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 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.
idType	String	N	Tipo de documento. Para CFCA este campo es Y. Valores posibles: SFZ: Documento de identidad HZ: Pasaporte
idNumber	String	N	Número de documento. Para CFCA este campo es Y.

Valor de retorno de la función

Nombre del parámetro	Tipo del parámetro	Obligatorio	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 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.
failReason	Object	N	Cuando Racent no logra solicitar el certificado a la CA y se puede identificar claramente el motivo del fallo, se devuelve este campo.
dataReasons	Array	N	Motivos de los datos
key	String	N	Elemento
reason	String	N	Motivo
sysReason	String	N	Motivo del sistema
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
DCVfileContent	String	N	Contenido del archivo de validación
DCVdnsHost	String	N	Valor del host para validación DNS
DCVdnsValue	String	N	Valor del registro para validación DNS
DCVdnsType	String	N	Tipo de registro para validación DNS
DCVfilePath	String	N	Ruta del archivo de validación
dcvInfo	Object	N	Cuando los valores de validación de cada dominio del certificado solicitado difieren, este campo es Y Cada elemento es de tipo Object y su nombre corresponde al dominio solicitado, por ejemplo: racent.com. Los detalles de cada elemento son los siguientes:
DCVfileName	String	N	Contenido del archivo de validación
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