2.1 Validar datos

2.1.1 Descripción de la interfaz

Entorno de prueba
Entorno real	https://portal.racent.com/ssl/validate
Método de solicitud	POST
content-type	multipart/form-data
Descripción	Esta interfaz se utiliza para validar todos los datos de pedido que usted transfiera. Llame a esta interfaz antes de llamar a la interfaz de pedido para garantizar un procesamiento fluido del pedido. Esta validación se utiliza para confirmar la información de su cuenta y asegurarse de que la información de su pedido sea correcta, devolviendo los códigos de error correspondientes (consulte el Apéndice 3.1).

2.1.2 Definición de parámetros

Nombre del parámetro	Tipo de parámetro	Obligatorio	Descripción
api_token	String	Y	Token de usuario. Para obtener el token, contacte con el soporte técnico de Racent
productCode	String	Y	Código del producto. Para obtener el código del producto, consulte la sección 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 verificación de la organización, admite formatos .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf, con un tamaño máximo de 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 (cadena JSON), descrita en detalle a continuación
csr	String	N	Cuando 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. Para parámetros de certificados SSL es Y; para otros tipos de productos es N. Si no se necesita este parámetro, utilice "other" por defecto.
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	Configuración unificada del método de verificación de 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 elemento es Y
domainInfo	String	N	Información del dominio, solo relevante para certificados SSL. Para 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 de nivel superior no existe, este campo es Y. Cuando el dcvMethod de nivel superior existe y este campo también existe, se priorizará el dcvMethod de nivel superior.
dcvEmail	String	N	Correo electrónico de validación del dominio. Cuando 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	Nombre de dominio
organizationInfo	String	N	Información de la empresa. Este parámetro es Y al solicitar productos que requieren validación empresarial. 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 el estándar ISO 3166-1).
organizationPostCode	String	N	Código postal de la ubicación de la empresa.
organizationRegNumber	String	N	Número de documento de la empresa. Para CFCA, este campo es Y.
idType	String	N	Tipo de documento de la empresa. Para CFCA, este campo es Y. Valores posibles: TYDMZ: Código unificado de crédito social OTHERS: Otro
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 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 donde se encuentra el 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 del lugar donde se encuentra el 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. Los valores son los siguientes: SFZ: documento de identidad HZ: pasaporte
idNumber	String	N	Número de documento de identidad. Para CFCA, este campo es Y.
finance	string		Solo está 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": "财务部", "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 del responsable financiero.
email	String	N	Correo electrónico del responsable financiero.
state	String	N	Provincia o estado del responsable financiero.
mobile	String	N	Teléfono de contacto del responsable financiero.
address	String	N	Dirección de contacto del responsable financiero.
country	String	N	País del oficial financiero (código de dos letras según el estándar ISO 3166-1).
lastName	String	N	Apellido del oficial financiero.
postCode	String	N	Código postal de la ubicación del oficial financiero.
firstName	String	N	Nombre del responsable financiero.
organation	String	N	Empresa del responsable financiero.
idType	String	N	Tipo de documento. En CFCA este campo es Y. Valores posibles: SFZ: Documento de identidad HZ: Pasaporte
idNumber	String	N	Número del documento de identidad. 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: SFZ：Documento de identidad HZ：Pasaporte
idNumber	String	N	Número de documento. Para CFCA, este campo es Y.

Valor devuelto por 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 del error.

2.1.3 Ejemplo de solicitud

请求示例

{
	"years": 2,
	"params": ‘{"server":"iis7","csr":"-----BEGIN CERTIFICATE REQUEST-----\nxxxxxxyyyoo\n-----END CERTIFICATE REQUEST-----\n","domainInfo":[{"domainName":"tt.cn","dcvMethod":"HTTP_CSR_HASH","dcvEmail":""}],"Administrator":{"organation":"cola","job":"it","firstName":"nick","lastName":"zhang","email":"xx@tt.com.cn","mobile":"13911111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4457145"},"finance":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"18111111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4514154"},"tech":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"15122222222","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"48787"},"organizationInfo":{"organizationCity":"上海","organizationState":"上海","organizationMobile":"153999999999","organizationAddress":"上海某地","organizationCountry":"CN","organizationPostCode":"200233","organizationName":"个人"}}’,
	"api_token": "zzzoooppzz",
	"productCode": "comodo-positivessl"
}