2.10 SSL-Abonnement verlängern

2.10.1 API-Informationen

Testumgebung
Live-Umgebung	https://portal.racent.com/ssl/renew
Anfragemethode	POST
content-type	multipart/form-data
Beschreibung	Diese Schnittstelle dient zur Verlängerung eines SSL-Abonnements. Eine Verlängerung ist nur zulässig, wenn der Status des SSL-Abonnements „Ausgestellt“ lautet und das Abonnement innerhalb von 30 Tagen abläuft.

2.10.2 Parameterdefinition

Parametername	Parametertyp	Pflichtfeld	Beschreibung
api_token	String	Y	Identitätsnachweis. Zur Token-Erstellung kontaktieren Sie bitte den technischen Support von Racent.
renewId	String	Y	Racent-Zertifikats-ID
years	Int	Y	Verlängerungsjahre (derzeit werden nur 1, 2, 3, 4, 5 unterstützt), abhängig vom jeweiligen Produkt.
refId	String	N	Eindeutige Kundenauftragsnummer, die vom Kunden bereitgestellt wird
verificationPic	File	N	Alternatives Verifizierungsmaterial. Für die Organisationsvalidierung, unterstützt die Formate .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf, Größe maximal 2M.
domainVerificationPic	File	N	Wenn die Domain-Validierungsmethode VERIFY_DOCUMENT ist, ist dieses Feld Y. Wird für die Domain Control Validation (DCV) verwendet (derzeit wird nur CFCA unterstützt).
params	String	Y	Bestellinformationen, im Folgenden detailliert beschrieben
csr	String	N	Wenn der Parameter leer ist, wird die CSR für Sie generiert und der private Schlüssel gespeichert.
privateKey	String	N	Privater Schlüssel.
server	String	N	Server. Nur für SSL-Zertifikate relevant. Für SSL-Zertifikat-Parameter ist der Wert Y, für andere Produkttypen N. Wenn dieser Parameter nicht benötigt wird, bitte standardmäßig „other“ verwenden.
orgCheck	Int	N	Wert ist 0 oder 1. Bei Wert 1 werden anhand der von Ihnen übermittelten Organisationsinformationen alle Organisationen unter Ihrem Konto abgerufen. Existiert die Organisation bereits, werden die zugehörigen Informationen der bestehenden Organisation verwendet; existiert sie nicht, wird sie als neue Organisation gespeichert. Bei Wert 0 werden keine Organisationsinformationen gespeichert.
duplicateOrgCheck	Int	N	Wert ist 0 oder 1. Dieser Parameter ist derzeit nur für Digicert SSL-Zertifikate relevant. Dient zur Feststellung, ob zuvor validierte Organisations- und Domäneninformationen wiederverwendet werden sollen. Bei Wert 1 werden sie wiederverwendet. Bei Wert 0 wird neu angelegt. Standardmäßig 1.
uniqueValue	String	N	Nur für Sectigo-Produkte relevant. 1–20 Zeichen (a-z A-Z 0-9) zur eigenständigen Generierung eines Validierungswerts durch den Distributor.
dcvMethod	String	N	Legt einheitlich die Validierungsmethode für die beantragte Domain fest. Muss eine der folgenden vier Methoden sein: EMAIL (E-Mail-Validierung) HTTP_CSR_HASH (Dateivalidierung) CNAME_CSR_HASH (DNS-Validierung) HTTPS_CSR_HASH (HTTPS-Dateivalidierung) VERIFY_DOCUMENT (Domain-Zertifikatsnachweis, nur für CFCA unterstützt) Für CFCA ist dieser Wert Y
domainInfo	String	N	Domaininformationen, nur für SSL-Zertifikate relevant. Für SSL-Zertifikate ist der Parameter Y, für andere Typen N. Für CFCA ist dieser Wert N. Beispiel: [ { "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" } ] Detaillierte Beschreibung wie folgt:
dcvMethod	String	N	Methode zur Domain-Validierung. Muss eine der folgenden vier Methoden sein: EMAIL (E-Mail-Validierung) HTTP_CSR_HASH (Dateivalidierung) CNAME_CSR_HASH (DNS-Validierung) HTTPS_CSR_HASH (HTTPS-Dateivalidierung)
dcvEmail	String	N	E-Mail-Adresse für die Domain-Validierung. Wenn die Validierungsmethode EMAIL ist, ist dieses Feld erforderlich (Y).
domainName	String	N	Domainname
organizationInfo	String	N	Unternehmensinformationen. Dieser Parameter ist Y, wenn Produkte bestellt werden, die eine Unternehmensvalidierung erfordern. Bei CFCA ist dieser Parameter N. Beispiel: { "organizationCity": "上海", "organizationName": "某公司", "organizationMobile": "18111111111", "organizationAddress": "上海市路", "organizationCountry": "CN", "organizationPostCode": "401320" }"
organizationCity	String	N	Stadt, in der sich das Unternehmen befindet.
organizationName	String	N	Name des Unternehmens.
organizationMobile	String	N	Firmen-Telefonnummer.
organizationAddress	String	N	Firmenadresse.
organizationCountry	String	N	Land des Unternehmens (zweibuchstabiger Code gemäß ISO 3166-1-Standard).
organizationPostCode	String	N	Postleitzahl des Unternehmensstandorts.
Administrator	String	Y	Administratordaten, Kontaktperson. Bei der Beantragung von Code-Signatur, E-Mail-Signatur oder Dokumentensignatur dient dieser Parameter als Antragsinformation. Wenn csr außerdem auf N gesetzt ist, werden diese Informationen für die Erstellung des CSR verwendet. Bei CFCA ist dieser Parameter N. { "job": "Geschäftsleitung", "city": "Shanghai", "email": "xx@yy.com", "state": "Shanghai", "mobile": "18111111111", "address": "Shanghai", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "Beispielunternehmen" }"
job	String	Y	Position des Administrators.
city	String	Y	Stadt, in der sich der Administrator befindet.
email	String	Y	E-Mail-Adresse des Administrators.
state	String	Y	Provinz oder Bundesland des Administrators.
mobile	String	Y	Kontakttelefonnummer des Administrators.
address	String	Y	Kontaktadresse des Administrators.
country	String	Y	Land des Administrators (zweistelliger Code nach ISO 3166-1).
lastName	String	Y	Nachname des Administrators.
postCode	String	Y	Postleitzahl des Standorts des Administrators.
firstName	String	Y	Name des Administrators.
organation	String	Y	Firmenname des Administrators.
finance	String		Nur im Zusammenhang mit SSL-Zertifikaten. Informationen der Finanzabteilung. Kann mit den Administratorinformationen übereinstimmen. Wenn das bestellte Produkt nicht vom Typ DV ist, ist dieser Parameter Y. Für CFCA ist dieser Parameter N. { "job": "Finanzabteilung", "city": "Shanghai", "email": "xx@yy.com", "state": "Shanghai", "mobile": "18111111111", "address": "Shanghai", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
job	String	N	Position des Finanzmitarbeiters.
city	String	N	Stadt des Finanzmitarbeiters.
email	String	N	E-Mail-Adresse des Finanzmitarbeiters.
state	String	N	Bundesland oder Staat, in dem sich die Finanzabteilung befindet.
mobile	String	N	Kontaktinformationen der Finanzabteilung.
address	String	N	Kontaktadresse der Finanzabteilung.
country	String	N	Land der Finanzverantwortlichen (zweistelliger Code gemäß ISO 3166-1).
lastName	String	N	Nachname der Finanzverantwortlichen.
postCode	String	N	Postleitzahl des Standorts der Finanzverantwortlichen.
firstName	String	N	Name des Finanzsachbearbeiters.
organation	String	N	Unternehmen des Finanzsachbearbeiters.
tech	String	N	Nur für SSL-Zertifikate relevant. Informationen zum Techniker. Wenn das bestellte Produkt nicht vom Typ dv ist, ist dieser Parameter Y. Bei CFCA ist dieser Parameter N. { "job": "技术部","city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
job	String	N	Position des Technikers.
city	String	N	Stadt des Technikers.
email	String	N	E-Mail des Technikers.
state	String	N	Bundesland oder Staat, in dem sich der Techniker befindet.
mobile	String	N	Kontaktinformationen des Technikers.
address	String	N	Kontaktadresse des Technikers.
country	String	N	Land des Technikers (zweibuchstabiger Code gemäß ISO 3166-1).
lastName	String	N	Nachname des Technikers.
postCode	String	N	Postleitzahl des Standorts des Technikers.
firstName	String	N	Name des Technikers.
organation	String	N	Unternehmen des Technikers.

Rückgabewerte der Funktion

Parametername	Parametertyp	Erforderlich	Beschreibung
code	Int	Y	Rückgabestatus, Details siehe Anhang 3.1
errors	Object oder String	N	Bei einem Fehlerstatus die konkrete Fehlermeldung.
data	Object	N	Bei erfolgreichem Status ist dieser Parameter vorhanden. Details siehe unten:
certId	String	N	racent-Zertifikats-ID. Bitte sorgfältig aufbewahren; dieser Parameter ist die eindeutige Kennung der racent-Instanz.
vendorId	String	N	CA-Bestellnummer.
vendorCertId	String	N	CA-Zertifikatsnummer.
DCVfileName	String	N	Dateiname der Dateivalidierung
DCVfileContent	String	N	Inhalt der Dateivalidierungsdatei
DCVdnsHost	String	N	DNS-Validierung Host-Wert
DCVdnsValue	String	N	DNS-Validierung Datensatzwert
DCVdnsType	String	N	DNS-Validierung Datensatztyp
DCVfilePath	String	N	Pfad der Dateivalidierungsdatei
dcvInfo	Object	N	Wenn die Validierungswerte für jede Domain im Zertifikatsantrag unterschiedlich sind, ist dieses Feld Y Jeder Eintrag ist vom Typ Object, der Objektname ist die beantragte Domain, z. B.: racent.com. Details zu jedem Eintrag:
DCVfileName	String	N	Inhalt der Dateivalidierungsdatei
DCVfileContent	String	N	Inhalt der Dateivalidierungsdatei
DCVdnsHost	String	N	DNS-Validierung Host-Wert
DCVdnsValue	String	N	DNS-Validierung Datensatzwert
DCVdnsType	String	N	DNS-Validierung Datensatztyp
DCVfilePath	String	N	Dateipfad für die Dateivalidierung