2.1 Validation des données

2.1.1 Description de l’interface

Environnement de test
Environnement réel	https://portal.racent.com/ssl/validate
Méthode de requête	POST
content-type	multipart/form-data
Description	Cette interface est utilisée pour valider toutes les données de commande que vous transmettez. Veuillez appeler cette interface avant d’appeler l’interface de commande afin de garantir un traitement fluide de la commande. Cette validation sert à confirmer les informations de votre compte ainsi qu’à vérifier l’exactitude de vos informations de commande, et renvoie les codes d’erreur correspondants (voir annexe 3.1).

2.1.2 Définition des paramètres

Nom du paramètre	Type de paramètre	Requis	Description
api_token	String	Y	Jeton utilisateur ; pour l'obtenir, veuillez contacter le support technique de Racent
productCode	String	Y	Code produit ; pour l'obtenir, voir 2.7
years	Int	Y	Durée d'achat en années (actuellement seules les valeurs 1, 2, 3, 4, 5 sont prises en charge), selon le produit spécifique.
refId	String	N	Numéro de commande client unique fourni par le client
verificationPic	File	N	Pièces justificatives de secours. Utilisées pour la validation de l’organisation. Formats acceptés : .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf, taille maximale 2 Mo.
domainVerificationPic	File	N	Obligatoire (Y) lorsque la méthode de validation du domaine est VERIFY_DOCUMENT. Utilisé pour la validation du contrôle de domaine (DCV) (actuellement pris en charge uniquement pour CFCA).
params	String	Y	Informations de commande (chaîne JSON), description détaillée ci-dessous
csr	String	N	Lorsque ce paramètre est vide, une CSR sera générée pour vous et la clé privée sera enregistrée.
privateKey	String	N	Clé privée.
server	String	N	Serveur. Concerne uniquement les certificats SSL. Pour les certificats SSL, le paramètre est Y ; pour les autres types de produits, il est N. Si ce paramètre n’est pas requis, utilisez « other » par défaut.
uniqueValue	String	N	Concerne uniquement les produits Sectigo. 1 à 20 caractères (a-z A-Z 0-9) utilisés par le distributeur pour générer lui-même la valeur de validation.
dcvMethod	String	N	Définit uniformément la méthode de validation du domaine lors de la demande de certificat. Doit être l’une des quatre méthodes suivantes : EMAIL (validation par e-mail) HTTP_CSR_HASH (validation par fichier) CNAME_CSR_HASH (validation DNS) HTTPS_CSR_HASH (validation par fichier HTTPS) VERIFY_DOCUMENT (preuve par certificat de domaine, prise en charge uniquement pour CFCA) Pour CFCA, ce paramètre est Y
domainInfo	String	N	Informations sur le domaine, uniquement liées aux certificats SSL. Le paramètre est Y pour les certificats SSL et N pour les autres types. Exemple : [ { "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" } ] Description détaillée comme suit :
dcvMethod	String	N	Méthode de validation du domaine (DCV). Doit être l’une des quatre méthodes suivantes : EMAIL (validation par e-mail) HTTP_CSR_HASH (validation par fichier) CNAME_CSR_HASH (validation DNS) HTTPS_CSR_HASH (validation par fichier HTTPS) Lorsque le dcvMethod de niveau supérieur n’existe pas, cet élément est Y. Lorsque le dcvMethod de niveau supérieur existe et que cet élément existe également, le dcvMethod de niveau supérieur est prioritaire.
dcvEmail	String	N	E-mail de validation du domaine. Lorsque cet élément est N, la valeur par défaut est la suivante racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com
domainName	String	N	Domaine
organizationInfo	String	N	Informations sur l’entreprise. Ce paramètre est Y lors de la commande de produits nécessitant une validation d’entreprise. Exemple : { "organizationCity": "上海", "organizationName": "某公司", "organizationMobile": "18111111111", "organizationAddress": "上海市路", "organizationCountry": "CN", "organizationPostCode": "401320" }"
organizationCity	String	N	Ville de l’entreprise.
organizationName	String	N	Nom de l’entreprise.
organizationMobile	String	N	Téléphone de l’entreprise.
organizationAddress	String	N	Adresse de l'entreprise.
organizationCountry	String	N	Pays de l'entreprise (code à deux lettres selon la norme ISO 3166-1).
organizationPostCode	String	N	Code postal du siège de l'entreprise.
organizationRegNumber	String	N	Numéro d’enregistrement de l’entreprise. Pour CFCA, ce champ est Y.
idType	String	N	Type de pièce d’identité de l’entreprise. Pour CFCA, ce champ est Y. Valeurs : TYDMZ : Code unifié de crédit social OTHERS : Autres
Administrator	string	Y	Informations de l’administrateur, contact. Lors d’une demande de certificat de signature de code, de signature d’e-mail ou de signature de document, ce paramètre sert d’informations de demande. De plus, si csr est N, ces informations servent à générer le csr. { "job": "总经办", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
job	String	Y	Poste de l’administrateur.
city	String	Y	Ville de l’administrateur.
email	String	Y	Adresse e-mail de l’administrateur.
state	String	Y	Province ou État de l'administrateur.
mobile	String	Y	Coordonnées de l'administrateur.
address	String	Y	Adresse de contact de l'administrateur.
country	String	Y	Pays de l’administrateur (code à deux lettres selon la norme ISO 3166-1).
lastName	String	Y	Nom de famille de l’administrateur.
postCode	String	Y	Code postal du lieu où se trouve l’administrateur.
firstName	String	Y	Nom de l'administrateur.
organation	String	Y	Nom de l'entreprise de l'administrateur.
idType	String	N	Type de pièce d'identité. Pour la CFCA, ce champ est Y. Valeurs : SFZ : carte d'identité HZ : passeport
idNumber	String	N	Numéro de pièce d’identité. Pour CFCA, cette valeur est Y.
finance	string		Concerne uniquement les certificats SSL. Informations sur le responsable financier. Peuvent être identiques aux informations de l’administrateur. Lorsque le produit commandé n’est pas de type DV, ce paramètre est Y. { "job": "Service financier", "city": "Shanghai", "email": "xx@yy.com", "state": "Shanghai", "mobile": "18111111111", "address": "Shanghai", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
job	String	N	Poste du responsable financier.
city	String	N	Ville où se trouve le responsable financier.
email	String	N	Adresse e-mail du responsable financier.
state	String	N	Province ou État où se trouve le responsable financier.
mobile	String	N	Coordonnées du responsable financier.
address	String	N	Adresse de contact du responsable financier.
country	String	N	Pays où se trouve le responsable financier (code à deux lettres selon la norme ISO 3166-1).
lastName	String	N	Nom de famille du responsable financier.
postCode	String	N	Code postal de la localité du responsable financier.
firstName	String	N	Prénom de l’agent financier.
organation	String	N	Société de l’agent financier.
idType	String	N	Type de pièce d’identité. Pour CFCA, ce champ est Y. Valeurs : SFZ : carte d’identité HZ : passeport
idNumber	String	N	Numéro de pièce d’identité. Pour CFCA, ce champ est Y.
tech	string	N	Uniquement lié aux certificats SSL. Informations du technicien. Lorsque le produit commandé n’est pas de type dv, ce paramètre est Y. { "job": "技术部","city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
job	String	N	Poste du technicien.
city	String	N	Ville où se trouve le technicien.
email	String	N	Adresse e-mail du technicien.
state	String	N	Province ou État où se trouve le technicien.
mobile	String	N	Coordonnées du technicien.
address	String	N	Adresse de contact du technicien.
country	String	N	Pays où se trouve le technicien (code à deux lettres selon la norme ISO 3166-1).
lastName	String	N	Nom du technicien.
postCode	String	N	Code postal du technicien.
firstName	String	N	Prénom du technicien.
organation	String	N	Entreprise du technicien.
idType	String	N	Type de pièce d’identité. Pour CFCA, ce champ est Y. Valeurs possibles : SFZ : Carte d’identité HZ : Passeport
idNumber	String	N	Numéro de pièce d’identité. Pour CFCA, ce champ est Y.

Valeur renvoyée par la fonction

Nom du paramètre	Type du paramètre	Requis	Description
code	Int	Y	Statut renvoyé. Pour plus de détails, reportez-vous à l’annexe 3.1.
errors	Object ou String	N	Message d’erreur lorsque le statut renvoyé est une erreur.

2.1.3 Exemple de demande

请求示例

{
	"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"
}