2.3 Obtenir le statut de la demande de certificat

2.3.1 Informations sur l’API

Environnement de test
Environnement réel	https://portal.racent.com/ssl/collect
Méthode de requête	POST
content-type	multipart/form-data
Description	Cette interface est utilisée pour obtenir l’état de la commande de certificat, récupérer le certificat et obtenir les informations de validation.

2.3.2 Définition des paramètres

Nom du paramètre	Type de paramètre	Requis	Description
certId	String	Y	ID de certificat Racent
api_token	String	Y	Identifiant d’authentification ; pour générer un token, veuillez contacter le support technique Racent.

Valeur renvoyée par la fonction

Nom du paramètre	Type du paramètre	Requis	Description
code	int	Y	État renvoyé ; pour plus de détails, voir l’annexe 3.1
status	String	Y	État de la commande : PENDING : en cours de demande COMPLETE : demande réussie CANCELLED : annulée REISSUED : réémise FAILED : échec de la demande RENEWED : renouvelée REVOKED : révoquée
certStatus	String	Y	État du certificat : PENDING : en cours de demande COMPLETE : demande réussie CANCELLED : annulée REISSUED : réémise FAILED : échec de la demande RENEWED : renouvelée REVOKED : révoquée
data	Object	N	Données renvoyées, détails ci-dessous
failReason	Object	N	Lorsque le statut est FAILED, ce paramètre est Y, motif de l’échec
dataReasons	Array	N	Motifs liés aux données
key	String	N	Élément
reason	String	N	Motif
sysReason	String	N	Motif système
beginDate	String	N	Lorsque le statut est COMPLETE, ce paramètre est Y, date de début du certificat
endDate	String	N	Lorsque le statut est COMPLETE, ce paramètre est Y, date de fin du certificat
certificate	String	N	Lorsque le statut est COMPLETE, ce paramètre est Y, certificat pem
caCertificate	String	N	Lorsque le statut est COMPLETE, ce paramètre est Y, certificat intermédiaire pem
jks	String	N	Lorsque le statut est COMPLETE et que Racent dispose des informations de clé privée correctes, ce paramètre est Y, encodage base64 du contenu du certificat jks.
jksPass	String	N	Lorsque le statut est COMPLETE et que Racent dispose des informations de clé privée correctes, ce paramètre est Y, mot de passe du certificat jks.
pkcs12	String	N	Lorsque le statut est COMPLETE et que Racent dispose des informations de clé privée correctes, ce paramètre est Y, encodage base64 du contenu du certificat PKCS12.
pkcsPass	String	N	Lorsque le statut est COMPLETE et que Racent dispose des informations de clé privée correctes, ce paramètre est Y, mot de passe du certificat PKCS12.
privateKey	String	N	Lorsque le statut est COMPLETE et que Racent dispose des informations de clé privée correctes, ce paramètre est Y, informations de clé privée
rsaPrivateKey	String	N	Clé privée au format rsa, lorsque le statut est COMPLETE et que Racent dispose des informations de clé privée correctes, ce paramètre est Y, informations de clé privée
replaceCertId	String	N	Lorsque le statut est REISSUED, ce paramètre est Y, ID du certificat Racent après réémission
oldCertId	String	N	Lorsque le certificat demandé est un certificat réémis, ce paramètre est Y, ancien ID de certificat Racent
vendorId	String	N	Numéro de commande CA
vendorCertId	String	N	Numéro de certificat CA (numéro de commande Sectigo)
DCVfileName	String	N	Validation par fichier de domaine, nom du fichier
DCVfileContent	String	N	Validation par fichier, contenu du fichier
DCVdnsHost	String	N	Validation DNS, hôte
DCVdnsValue	String	N	Validation DNS, valeur
DCVdnsType	String	N	Validation DNS, type
dcvInfo	Object	N	Lorsque les valeurs de validation diffèrent pour chaque domaine dans la demande de certificat, cet élément est Y Chaque entrée est de type Object, chaque objet porte le nom du domaine demandé, par ex. racent.com. Détails de chaque entrée ci-dessous :
DCVfileName	String	N	Validation par fichier de domaine, nom du fichier
DCVfileContent	String	N	Validation par fichier, contenu du fichier
DCVdnsHost	String	N	Validation DNS, hôte
DCVdnsValue	String	N	Validation DNS, valeur
DCVdnsType	String	N	Validation DNS, type
DCVfilePath	String	N	Chemin du fichier de validation par fichier
dcvList	Array	N	Liste de validation du contrôle de domaine, chaque élément est de type Object, détail de chaque élément comme suit :
domainName	String	N	Nom de domaine
dcvMethod	String	N	Méthode de validation du domaine
dcvEmail	String	N	E-mail de validation du domaine
is_verify	String	N	La valeur du paramètre vérifié est « verified » ; non vérifié, aucun paramètre.
application	Object	N	Statut de la demande de commande
status	String	N	Le paramètre prend l’une des valeurs suivantes : notdone : non terminé done : terminé ongoing : en cours
dcv	Object	N	Statut de la validation de domaine
status	String	N	Le paramètre prend l’une des valeurs suivantes : notdone : non terminé done : terminé ongoing : en cours
ov	Object	N	Statut de la validation de l’organisation
status	String	N	Le paramètre prend l’une des valeurs suivantes : notdone : non terminé done : terminé ongoing : en cours
issued	Object	N	Statut d’émission
status	String	N	Le paramètre prend l’une des valeurs suivantes : notdone : non terminé done : terminé ongoing : en cours
applyParams	Object	N	Paramètres de la demande, consultez les paramètres de requête de l’interface de demande (place) pour plus de détails
csr	String	N	csr
Administrator	Object	N	Informations de l’administrateur
job	String	N	Poste
city	String	N	Ville
email	String	N	E-mail
state	String	N	Province ou État
mobile	String	N	Coordonnées
address	String	N	Adresse de contact
country	String	N	Pays (code à deux lettres selon la norme ISO 3166-1).
lastName	String	N	Nom de famille
postCode	String	N	Code postal
firstName	String	N	Prénom
organation	String	N	Nom de l’entreprise
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 la CFCA, ce champ est Y.
tech	Object	N	Informations sur le technicien ; les éléments sont identiques à ceux des informations sur l’administrateur.
finance	Object	N	Informations sur le responsable financier ; les éléments sont identiques à ceux des informations sur l’administrateur.
organizationInfo	Object	N	Informations sur l’entreprise
organizationCity	String	N	Ville
organizationName	String	N	Nom
organizationMobile	String	N	Téléphone
organizationAddress	String	N	Adresse
organizationCountry	String	N	Pays
organizationPostCode	String	N	Code postal
organizationRegNumbe	String	N	Numéro de document de l’entreprise. Pour la CFCA, cet élément est Y.
idType	String	N	Type de document de l’entreprise. Pour la CFCA, cet élément est Y. Valeurs possibles : TYDMZ : Code unifié de crédit social OTHERS : Autre
errors	Object ou String	N	Lorsque l’état de retour est une erreur, informations détaillées sur l’erreur.