2.3 Status des Zertifikatsantrags abrufen

2.3.1 API-Informationen

Testumgebung
Produktivumgebung	https://portal.racent.com/ssl/collect
Anfragemethode	POST
content-type	multipart/form-data
Beschreibung	Diese Schnittstelle dient zum Abrufen des Bestellstatus eines Zertifikats, zum Abrufen des Zertifikats und zum Abrufen von Validierungsinformationen.

2.3.2 Parameterdefinition

Parametername	Parametertyp	Pflicht	Beschreibung
certId	String	Y	racent-Zertifikats-ID
api_token	String	Y	Identitätsnachweis. Zur Token-Erstellung kontaktieren Sie bitte den technischen Support von Racent.

Funktionsrückgabe

Parametername	Parametertyp	Pflicht	Beschreibung
code	int	Y	Rückgabestatus, Einzelheiten siehe Anhang 3.1
status	String	Y	Bestellstatus: PENDING: Beantragt COMPLETE: Antrag erfolgreich CANCELLED: Storniert REISSUED: Neu ausgestellt FAILED: Antrag fehlgeschlagen RENEWED: Verlängert REVOKED: Widerrufen
certStatus	String	Y	Zertifikatsstatus: PENDING: Beantragt COMPLETE: Antrag erfolgreich CANCELLED: Storniert REISSUED: Neu ausgestellt FAILED: Antrag fehlgeschlagen RENEWED: Verlängert REVOKED: Widerrufen
data	Object	N	Zurückgegebene Daten, Details wie folgt
failReason	Object	N	Wenn der Status FAILED ist, ist dieser Parameter Y, Grund des Fehlschlags
dataReasons	Array	N	Datengründe
key	String	N	Element
reason	String	N	Grund
sysReason	String	N	Systemgrund
beginDate	String	N	Wenn der Status COMPLETE ist, ist dieser Parameter Y, Startzeit des Zertifikats
endDate	String	N	Wenn der Status COMPLETE ist, ist dieser Parameter Y, Endzeit des Zertifikats
certificate	String	N	Wenn der Status COMPLETE ist, ist dieser Parameter Y, PEM-Zertifikat
caCertificate	String	N	Wenn der Status COMPLETE ist, ist dieser Parameter Y, PEM-Zwischenzertifikat
jks	String	N	Wenn der Status COMPLETE ist und Racent über korrekte Informationen zum privaten Schlüssel verfügt, ist dieser Parameter Y, Base64-Kodierung des JKS-Zertifikatinhalts.
jksPass	String	N	Wenn der Status COMPLETE ist und Racent über korrekte Informationen zum privaten Schlüssel verfügt, ist dieser Parameter Y, das Zertifikatspasswort des JKS.
pkcs12	String	N	Wenn der Status COMPLETE ist und Racent über korrekte Informationen zum privaten Schlüssel verfügt, ist dieser Parameter Y, Base64-Kodierung des PKCS12-Zertifikatinhalts.
pkcsPass	String	N	Wenn der Status COMPLETE ist und Racent über korrekte Informationen zum privaten Schlüssel verfügt, ist dieser Parameter Y, das Zertifikatspasswort des PKCS12.
privateKey	String	N	Wenn der Status COMPLETE ist und Racent über korrekte Informationen zum privaten Schlüssel verfügt, ist dieser Parameter Y, Informationen zum privaten Schlüssel
rsaPrivateKey	String	N	Privater Schlüssel im RSA-Format. Wenn der Status COMPLETE ist und Racent über korrekte Informationen zum privaten Schlüssel verfügt, ist dieser Parameter Y, Informationen zum privaten Schlüssel
replaceCertId	String	N	Wenn der Status REISSUED ist, ist dieser Parameter Y, die Racent-Zertifikat-ID nach der Neuausstellung
oldCertId	String	N	Wenn das beantragte Zertifikat ein neu ausgestelltes Zertifikat ist, ist dieser Parameter Y, die alte Racent-Zertifikat-ID
vendorId	String	N	CA-Bestellnummer
vendorCertId	String	N	CA-Zertifikatsnummer (Sectigo-Bestellnummer)
DCVfileName	String	N	Dateibasierte Domänenvalidierung, Dateiname
DCVfileContent	String	N	Dateivalidierung, Dateiinhalt
DCVdnsHost	String	N	DNS-Validierung, Host
DCVdnsValue	String	N	DNS-Validierung, Wert
DCVdnsType	String	N	DNS-Validierung, Typ
dcvInfo	Object	N	Wenn die Validierungswerte für jede Domain im Zertifikatsantrag unterschiedlich sind, ist dieser Wert Y. Jeder Eintrag ist vom Typ Object, der Objektname ist die beantragte Domain, z. B. racent.com. Details zu jedem Eintrag:
DCVfileName	String	N	Dateibasierte Domänenvalidierung, Dateiname
DCVfileContent	String	N	Dateivalidierung, Dateiinhalt
DCVdnsHost	String	N	DNS-Validierung, Host
DCVdnsValue	String	N	DNS-Validierung, Value
DCVdnsType	String	N	DNS-Validierung, Type
DCVfilePath	String	N	Dateipfad für Dateivalidierung
dcvList	Array	N	Liste zur Domainvalidierung, jedes Element ist vom Typ Object, Details zu jedem Element wie folgt:
domainName	String	N	Domainname
dcvMethod	String	N	Methode zur Domainvalidierung
dcvEmail	String	N	E-Mail für Domainvalidierung
is_verify	String	N	Verifizierter Parameterwert ist „verified“, ohne Verifizierung kein Parameter
application	Object	N	Status der Auftragsübermittlung
status	String	N	Der Parameter hat einen der folgenden Werte: notdone: nicht abgeschlossen done: abgeschlossen ongoing: in Bearbeitung
dcv	Object	N	Status der Domain-Validierung
status	String	N	Der Parameter hat einen der folgenden Werte: notdone: nicht abgeschlossen done: abgeschlossen ongoing: in Bearbeitung
ov	Object	N	Status der Organisationsvalidierung
status	String	N	Der Parameter hat einen der folgenden Werte: notdone: nicht abgeschlossen done: abgeschlossen ongoing: in Bearbeitung
issued	Object	N	Ausstellungsstatus
status	String	N	Der Parameter hat einen der folgenden Werte: notdone: nicht abgeschlossen done: abgeschlossen ongoing: in Bearbeitung
applyParams	Object	N	Antragsparameter, Details finden Sie in den Anfrageparametern der Antragsschnittstelle (place)
csr	String	N	csr
Administrator	Object	N	Administratorinformationen
job	String	N	Position
city	String	N	Stadt
email	String	N	E-Mail
state	String	N	Provinz oder Bundesland
mobile	String	N	Kontaktmöglichkeit
address	String	N	Kontaktadresse
country	String	N	Land (Zwei-Buchstaben-Code nach ISO 3166-1).
lastName	String	N	Nachname
postCode	String	N	Postleitzahl
firstName	String	N	Vorname
organation	String	N	Firmenname
idType	String	N	Ausweistyp. Bei CFCA ist dieses Feld Y. Werte wie folgt: SFZ: Personalausweis HZ: Reisepass
idNumber	String	N	Ausweisnummer. Bei CFCA ist dieses Feld Y.
tech	Object	N	Informationen zum Techniker, die einzelnen Positionen entsprechen denen der Administratorinformationen
finance	Object	N	Informationen zum Finanzbeauftragten, die einzelnen Positionen entsprechen denen der Administratorinformationen
organizationInfo	Object	N	Unternehmensinformationen
organizationCity	String	N	Stadt
organizationName	String	N	Name
organizationMobile	String	N	Telefon
organizationAddress	String	N	Adresse
organizationCountry	String	N	Land
organizationPostCode	String	N	Postleitzahl
organizationRegNumbe	String	N	Firmenregistrierungsnummer. Bei CFCA ist dieses Feld Y.
idType	String	N	Typ des Firmenregistrierungsdokuments. Bei CFCA ist dieses Feld Y. Werte wie folgt: TYDMZ：Einheitlicher Sozialkreditcode OTHERS：Sonstige
errors	Objekt oder String	N	Konkrete Fehlermeldung, wenn der Rückgabestatus „Fehler“ lautet.