2.21 Modifier les informations de demande

2.21.1 Informations sur l'API

Environnement de test
Environnement réel	https://portal.racent.com/ssl/alter
Méthode de requête	POST
content-type	multipart/form-data
Description	Cette interface est uniquement utilisée pour modifier les informations de demande lorsque la demande de certificat CFCA a échoué.

2.21.2 Définition des paramètres

Nom du paramètre	Type de paramètre	Requis	Description
api_token	String	Y	Identifiants d’identité. Pour générer un jeton, veuillez contacter le support technique de Racent.
certId	String	Y	ID de certificat racent
refId	String	N	Numéro de commande client unique fourni par le client
verificationPic	File	N	Matériel de vérification de secours. Utilisé pour la prévalidation de l’organisation. Formats pris en charge : .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip, taille maximale 2 Mo.
domainVerificationPic	File	N	Lorsque la méthode de validation du contrôle de domaine (DCV) est : VERIFY_DOCUMENT, ce champ est Y. Utilisé pour la validation du contrôle de domaine (DCV) (actuellement pris en charge uniquement par CFCA).
params	String	Y	Informations de commande, description détaillée ci-dessous
csr	String	N	Lorsque le paramètre est vide, un CSR sera généré pour vous et la clé privée sera conservée.
privateKey	String	N	Clé privée.
server	String	N	Serveur. Concerne uniquement les certificats SSL. Le paramètre est Y pour un certificat SSL et N pour les autres types de produits. Si ce paramètre n’est pas nécessaire, utilisez « other » par défaut.
orgCheck	Int	N	Valeur 0 ou 1. Lorsque la valeur est 1, les informations d'organisation que vous avez soumises seront utilisées pour rechercher toutes les organisations sous votre compte. Si une organisation existe, les informations associées de l'organisation existante seront utilisées ; si elle n'existe pas, nous l'enregistrerons comme une nouvelle organisation. Lorsque la valeur est 0, les informations d'organisation ne seront pas enregistrées.
duplicateOrgCheck	Int	N	Valeur 0 ou 1. Ce paramètre est actuellement uniquement lié aux certificats SSL Digicert. Il est utilisé pour déterminer s'il faut réutiliser les informations d'organisation et de domaine précédemment validées. Lorsque la valeur est 1, réutilisation. Lorsque la valeur est 0, nouvelle création. La valeur par défaut est 1.
dcvMethod	String	N	Définit de manière unifiée la méthode de validation pour la demande de domaine. 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 de certificat de domaine, uniquement pris en charge par CFCA) Pour CFCA, cet élément 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 de paramètres. Le nombre total de domaines standard et le nombre total de domaines génériques ne peuvent pas dépasser respectivement le nombre total de domaines standard et le nombre total de domaines génériques achetés. 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. 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 dcvMethod du niveau supérieur n’existe pas, cet élément est Y. Lorsque dcvMethod du niveau supérieur existe et que cet élément existe aussi, dcvMethod du niveau supérieur est utilisé en priorité
dcvEmail	String	N	E-mail de validation du domaine. Lorsque cet élément est N, les valeurs par défaut sont les suivantes racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com
domainName	String	N	Nom de domaine
organizationInfo	String	N	Informations sur l’entreprise. Lors de la commande de produits nécessitant une validation d’entreprise, ce paramètre est Y. 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 où se trouve l’entreprise (code à deux lettres selon la norme ISO 3166-1).
organizationPostCode	String	N	Code postal du lieu d’implantation de l’entreprise.
organizationRegNumbe	String	N	Numéro de pièce d’identité de l’entreprise. Pour CFCA, ce champ est Y.
idType	String	N	Type de pièce d’identité de l’entreprise. Pour CFCA, cet élément est Y. Valeurs : TYDMZ : code unifié de crédit social OTHERS : autre
Administrator	String	Y	Informations de l’administrateur, contact. Lors de la demande d’un 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 conforme à 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	Prénom de l’administrateur.
organation	String	Y	Nom de l’entreprise de l’administrateur.
idType	String	N	Type de pièce d’identité. Cette rubrique est Y pour CFCA. Valeurs : SFZ : Carte d’identité HZ : Passeport
idNumber	String	N	Numéro de la pièce d’identité. Cette rubrique est Y pour CFCA.
finance	String		Uniquement lié aux certificats SSL. Informations sur le personnel financier. Peut être identique aux informations de l'administrateur. 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 personnel financier.
city	String	N	Ville du personnel 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 du 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 du lieu où se trouve le responsable financier.
firstName	String	N	Prénom du responsable financier.
organation	String	N	Société du responsable financier.
idType	String	N	Type de pièce d’identité. Pour CFCA, cet élément est Y. Valeurs : SFZ : carte d’identité HZ : passeport
idNumber	String	N	Numéro de pièce d’identité. Pour CFCA, cet élément est Y.
tech	String	N	Concerne uniquement les certificats SSL. Informations sur le 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 de famille du technicien.
postCode	String	N	Code postal du lieu où se trouve le technicien.
firstName	String	N	Prénom du technicien.
organation	String	N	Entreprise du technicien.
idType	String	N	Type de pièce d’identité. Ce champ est Y pour CFCA. Valeurs : SFZ : Carte d’identité HZ : Passeport
idNumber	String	N	Numéro de pièce d’identité. Ce champ est Y pour CFCA.

Retour de la fonction

code	Int	Y	État de retour, voir l’annexe 3.1 pour plus de détails
errors	Object or String	N	En cas d’état d’erreur, informations détaillées sur l’erreur.
data	Object	N	En cas d’état de succès, ce paramètre est Y. Description détaillée ci-dessous :
certId	String	N	ID du certificat racent. Veuillez le conserver précieusement ; ce paramètre est l’identifiant unique de l’instance racent.
vendorId	String	N	Numéro de commande CA.
vendorCertId	String	N	Numéro de certificat CA.
DCVfileName	String	N	Nom du fichier de validation par fichier
DCVfileContent	String	N	Contenu du fichier de validation par fichier
DCVdnsHost	String	N	Valeur d’hôte de validation DNS
DCVdnsValue	String	N	Valeur d’enregistrement de validation DNS
DCVdnsType	String	N	Type d’enregistrement de validation DNS
DCVfilePath	String	N	Chemin du fichier de validation par fichier
dcvInfo	Object	N	Quand la valeur de validation diffère pour chaque domaine de la demande de certificat, cet élément est Y Chaque élément est de type Object, chaque objet porte le nom du domaine demandé, par exemple : racent.com. Détails de chaque élément ci-dessous :
DCVfileName	String	N	Contenu du fichier de validation par fichier
DCVfileContent	String	N	Contenu du fichier de validation de fichier
DCVdnsHost	String	N	Valeur de l'hôte de validation Dns
DCVdnsValue	String	N	Valeur de l'enregistrement de validation Dns
DCVdnsType	String	N	Type d'enregistrement de validation Dns
DCVfilePath	String	N	Chemin du fichier de validation de fichier
failReason	Object	N	Lorsque Racent échoue à demander un certificat auprès de l'AC et que la raison de l'échec est clairement identifiée, cet élément est renvoyé.
dataReasons	Array	N	Raisons relatives aux données
key	String	N	Élément
reason	String	N	Raison
sysReason	String	N	Raison système