2.10 Renouvellement de l'abonnement SSL

2.10.1 Informations sur l’API

Environnement de test
Environnement réel	https://portal.racent.com/ssl/renew
Méthode de requête	POST
content-type	multipart/form-data
Description	Cette interface est utilisée pour renouveler un abonnement SSL. Le renouvellement n’est autorisé que lorsque l’abonnement SSL est à l’état émis et qu’il expire dans les 30 jours.

2.10.2 Définition des paramètres

Nom du paramètre	Type de paramètre	Obligatoire	Description
api_token	String	Y	Identifiants d’identité. Pour générer le jeton, veuillez contacter le support technique de Racent.
renewId	String	Y	ID du certificat Racent
years	Int	Y	Durée de renouvellement en années (actuellement, seules les valeurs 1, 2, 3, 4, 5 sont prises en charge), selon le produit concerné.
refId	String	N	Numéro de commande client unique fourni par le client
verificationPic	File	N	Document de vérification de secours. Utilisé pour la validation de l’organisation. Formats pris en charge : .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf, 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, seul CFCA est pris en charge).
params	String	Y	Informations de commande, décrites en détail 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. Uniquement lié au certificat 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 par défaut « other ».
orgCheck	Int	N	Valeur 0 ou 1. Lorsque la valeur est 1, toutes les organisations de votre compte sont recherchées sur la base des informations d'organisation que vous avez soumises. Si elles existent, les informations associées à l'organisation existante sont utilisées ; si elles n'existent pas, elles sont enregistrées comme nouvelle organisation. Lorsque la valeur est 0, les informations d'organisation ne sont pas enregistrées.
duplicateOrgCheck	Int	N	Valeur 0 ou 1. Ce paramètre est actuellement lié uniquement au certificat SSL Digicert. Il permet de déterminer s'il faut réutiliser les informations d'organisation et de domaine précédemment validées. Lorsque la valeur est 1, elles sont réutilisées. Lorsque la valeur est 0, elles sont recréées. Valeur par défaut : 1.
uniqueValue	String	N	Uniquement lié aux 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 de manière uniforme la méthode de validation du domaine de la demande. 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, pris en charge uniquement 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 SSL est Y, les autres types de paramètres sont N. Pour CFCA, cet élément est N. 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)
dcvEmail	String	N	E-mail de validation du domaine. Lorsque la méthode de validation est EMAIL, cet élément est Y.
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. Pour CFCA, ce paramètre est N. Exemple : { "organizationCity": "上海", "organizationName": "某公司", "organizationMobile": "18111111111", "organizationAddress": "上海市路", "organizationCountry": "CN", "organizationPostCode": "401320" }"
organizationCity	String	N	Ville où se trouve 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.
Administrator	String	Y	Informations sur l’administrateur et le contact. Lors d’une demande de certificat de signature de code, de signature d’e-mail ou de signature de document, ce paramètre est utilisé comme informations de demande. De plus, si csr est N, ces informations servent à générer le CSR. Pour CFCA, cet élément est N. { "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 où se trouve 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	Prénom de l’administrateur.
organation	String	Y	Nom de l’entreprise de l’administrateur.
finance	String		Uniquement lié aux certificats SSL. Informations du 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. Pour CFCA, cette valeur est N. { "job": "Service financier", "city": "Shanghai", "email": "xx@yy.com", "state": "Shanghai", "mobile": "18111111111", "address": "Shanghai", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "Une entreprise" }"
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 du lieu où se trouve le responsable financier.
firstName	String	N	Nom du responsable financier.
organation	String	N	Entreprise du responsable financier.
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. Pour CFCA, cet élément est N. { "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 du technicien (code à deux lettres selon la norme ISO 3166-1).
lastName	String	N	Nom de famille du technicien.
postCode	String	N	Code postal de la localité du technicien.
firstName	String	N	Prénom du technicien.
organation	String	N	Entreprise du technicien.

Valeur de retour de la fonction

Nom du paramètre	Type du paramètre	Requis	Description
code	Int	Y	État retourné. Pour plus de détails, reportez-vous à l'annexe 3.1.
errors	Object or String	N	Lorsque l'état retourné est une erreur, contient les informations spécifiques de l'erreur.
data	Object	N	Lorsque l'état retourné est un succès, ce paramètre est Y. Description détaillée ci-dessous :
certId	String	N	ID du certificat racent. À conserver précieusement, il s'agit de 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 de fichier pour la validation par fichier
DCVfileContent	String	N	Contenu du fichier pour la validation par fichier
DCVdnsHost	String	N	Valeur de l’hôte pour la validation DNS
DCVdnsValue	String	N	Valeur de l’enregistrement pour la validation DNS
DCVdnsType	String	N	Type d’enregistrement pour la validation DNS
DCVfilePath	String	N	Chemin du fichier pour la validation par fichier
dcvInfo	Object	N	Lorsque les valeurs de validation diffèrent pour chaque domaine dans 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. Le détail de chaque élément est le suivant :
DCVfileName	String	N	Contenu du fichier pour la validation par fichier
DCVfileContent	String	N	Contenu du fichier pour la validation par fichier
DCVdnsHost	String	N	Valeur de l’hôte pour la validation DNS
DCVdnsValue	String	N	Valeur de l’enregistrement pour la validation DNS
DCVdnsType	String	N	Type d’enregistrement pour la validation DNS
DCVfilePath	String	N	Chemin du fichier de validation du fichier