2.21 Antragsunterlagen ändern

2.21.1 API-Informationen

Testumgebung
Produktivumgebung	https://portal.racent.com/ssl/alter
Anfragemethode	POST
content-type	multipart/form-data
Beschreibung	Diese Schnittstelle wird nur verwendet, um Antragsdaten zu ändern, wenn ein CFCA-Zertifikatsantrag fehlgeschlagen ist.

2.21.2 Parameterdefinition

Parametername	Parametertyp	Pflichtfeld	Beschreibung
api_token	String	Y	Identitätsnachweis. Für die Token-Erstellung wenden Sie sich bitte an den technischen Support von Racent.
certId	String	Y	Racent-Zertifikats-ID
refId	String	N	Eindeutige Kundenbestellnummer, bereitgestellt vom Kunden
verificationPic	File	N	Zusätzliches Verifizierungsmaterial. Für die Organisationsvalidierung, unterstützt die Formate .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip, Größe maximal 2M.
domainVerificationPic	File	N	Wenn die Domain-Validierungsmethode VERIFY_DOCUMENT ist, ist dieses Feld Y. Für die Domain Control Validation (DCV) (derzeit nur CFCA unterstützt).
params	String	Y	Bestellinformationen, wie folgt beschrieben
csr	String	N	Wenn der Parameter leer ist, wird für Sie eine CSR generiert und der private Schlüssel gespeichert.
privateKey	String	N	Privater Schlüssel.
server	String	N	Server. Nur im Zusammenhang mit SSL-Zertifikaten relevant. Für SSL-Zertifikat-Parameter ist dieser Wert Y, für andere Produkttypen ist der Parameter N. Wenn dieser Parameter nicht benötigt wird, verwenden Sie standardmäßig „other“.
orgCheck	Int	N	Der Wert ist 0 oder 1. Bei 1 werden alle Organisationen unter Ihrem Konto anhand der von Ihnen übermittelten Organisationsinformationen abgerufen. Existiert die Organisation bereits, werden die zugehörigen Informationen verwendet; existiert sie nicht, wird sie als neue Organisation gespeichert. Bei 0 werden keine Organisationsinformationen gespeichert.
duplicateOrgCheck	Int	N	Der Wert ist 0 oder 1. Dieser Parameter bezieht sich derzeit nur auf Digicert SSL-Zertifikate. Er dient zur Feststellung, ob zuvor validierte Organisations- und Domaininformationen wiederverwendet werden sollen. Bei 1 werden sie wiederverwendet. Bei 0 wird neu angelegt. Standardwert ist 1.
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 (Domainzertifikatsnachweis, nur für CFCA unterstützt) Für CFCA ist dieser Wert Y
domainInfo	String	N	Domaininformationen, nur im Zusammenhang mit SSL-Zertifikaten. Bei SSL-Zertifikatsparametern Y, bei anderen Parametertypen N. Die Gesamtzahl der Standard-Domains und der Wildcard-Domains darf jeweils die beim Kauf angegebene Gesamtzahl der Standard-Domains bzw. der Wildcard-Domains nicht überschreiten. 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" } ] Details 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) Wenn die übergeordnete dcvMethod nicht vorhanden ist, ist dieses Feld Y. Wenn die übergeordnete dcvMethod vorhanden ist und dieses Feld ebenfalls vorhanden ist, hat die übergeordnete dcvMethod Vorrang.
dcvEmail	String	N	E-Mail-Adresse für die Domain-Validierung. Wenn dieses Feld N ist, gelten folgende Standardwerte: racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com
domainName	String	N	Domäne
organizationInfo	String	N	Unternehmensinformationen. Bei Bestellung eines Produkts, das eine Unternehmensvalidierung erfordert, ist dieser Parameter Y. Beispiel: { "organizationCity": "Shanghai", "organizationName": "Firma", "organizationMobile": "18111111111", "organizationAddress": "Straße in Shanghai", "organizationCountry": "CN", "organizationPostCode": "401320" }"
organizationCity	String	N	Stadt des Unternehmens.
organizationName	String	N	Firmenname.
organizationMobile	String	N	Firmen-Telefonnummer.
organizationAddress	String	N	Firmenadresse.
organizationCountry	String	N	Land des Unternehmens (aus dem ISO 3166-1-Standard übernommener Ländercode aus zwei Buchstaben).
organizationPostCode	String	N	Postleitzahl des Unternehmensstandorts.
organizationRegNumbe	String	N	Registrierungsnummer des Unternehmens. Bei CFCA ist dieses Feld Y.
idType	String	N	Art des Unternehmenstyps. Bei CFCA ist dieses Feld Y. Werte wie folgt: TYDMZ: Unified Social Credit Code OTHERS: Sonstige
Administrator	String	Y	Informationen zum Administrator und Kontaktperson. Bei Beantragung von Code-Signatur-, E-Mail-Signatur- oder Dokumentensignatur-Zertifikaten dient dieser Parameter als Antragsinformation. Falls csr außerdem N ist, werden diese Informationen zur CSR-Erzeugung verwendet. { "job": "Geschäftsleitung", "city": "Shanghai", "email": "xx@yy.com", "state": "Shanghai", "mobile": "18111111111", "address": "Shanghai", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "Firma" }"
job	String	Y	Position des Administrators.
city	String	Y	Stadt des Administrators.
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	Vorname des Administrators.
organation	String	Y	Firmenname des Administrators.
idType	String	N	Dokumenttyp. Bei CFCA ist dieses Feld Y. Werte wie folgt: SFZ: Personalausweis HZ: Reisepass
idNumber	String	N	Dokumentnummer. Bei CFCA ist dieses Feld Y.
finance	String		Nur SSL-Zertifikat-bezogen. Informationen der Finanzverantwortlichen. Kann mit den Administratorinformationen übereinstimmen. Wenn das bestellte Produkt nicht vom Typ DV ist, ist dieser Parameter Y. { "job": "财务部", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
job	String	N	Position der Finanzverantwortlichen.
city	String	N	Stadt der Finanzverantwortlichen.
email	String	N	E-Mail-Adresse des Finanzmitarbeiters.
state	String	N	Provinz oder Bundesland, in dem sich der Finanzmitarbeiter befindet.
mobile	String	N	Kontaktmöglichkeit des Finanzmitarbeiters.
address	String	N	Kontaktadresse des Finanzbeauftragten.
country	String	N	Land des Finanzbeauftragten (zweibuchstabiger Code nach ISO 3166-1).
lastName	String	N	Nachname des Finanzbeauftragten.
postCode	String	N	Postleitzahl des Standorts des Finanzmitarbeiters.
firstName	String	N	Vorname des Finanzmitarbeiters.
organation	String	N	Unternehmen des Finanzmitarbeiters.
idType	String	N	Dokumenttyp. Bei CFCA ist dieser Wert Y. Werte wie folgt: SFZ: Personalausweis HZ: Reisepass
idNumber	String	N	Dokumentnummer. Bei CFCA ist dieser Wert Y.
tech	String	N	Nur im Zusammenhang mit SSL-Zertifikaten. Informationen des Technikers. Wenn das bestellte Produkt nicht vom Typ dv ist, ist dieser Parameter Y. { "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	Provinz oder Bundesland, in dem sich der Techniker befindet.
mobile	String	N	Kontaktnummer des Technikers.
address	String	N	Kontaktadresse des Technikers.
country	String	N	Das Land, in dem sich der Techniker befindet (Zwei-Buchstaben-Code nach 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.
idType	String	N	Ausweistyp. Bei CFCA ist dieses Feld Y. Werte: SFZ: Personalausweis HZ: Reisepass
idNumber	String	N	Ausweisnummer. Bei CFCA ist dieses Feld Y.

Rückgabewert der Funktion

code	Int	Y	Rückgabestatus. Details siehe Anhang 3.1.
errors	Object oder String	N	Wenn der Rückgabestatus ein Fehler ist, die konkrete Fehlermeldung.
data	Object	N	Wenn der Rückgabestatus erfolgreich ist, ist dieser Parameter Y. Die konkrete Beschreibung lautet wie folgt:
certId	String	N	racent-Zertifikats-ID. Bitte bewahren Sie diese gut auf, dieser Parameter ist das eindeutige Berechtigungsnachweis der racent-Instanz.
vendorId	String	N	CA-Bestellnummer.
vendorCertId	String	N	CA-Zertifikatsnummer.
DCVfileName	String	N	Dateiname für die Dateivalidierung
DCVfileContent	String	N	Inhalt der Datei für die Dateivalidierung
DCVdnsHost	String	N	Host-Wert für die DNS-Validierung
DCVdnsValue	String	N	Record-Wert für die DNS-Validierung
DCVdnsType	String	N	Record-Typ für die DNS-Validierung
DCVfilePath	String	N	Pfad der Datei für die Dateivalidierung
dcvInfo	Object	N	Wenn die Validierungswerte der einzelnen Domains im Zertifikatsantrag unterschiedlich sind, ist dieser Parameter Y. Jeder Eintrag hat den Typ Object, der Objektname jedes Eintrags ist die beantragte Domain, z. B. racent.com. Die Details jedes Eintrags lauten wie folgt:
DCVfileName	String	N	Inhalt der Datei für die Dateivalidierung
DCVfileContent	String	N	Inhalt der Datei zur Dateivalidierung
DCVdnsHost	String	N	Hostwert für DNS-Validierung
DCVdnsValue	String	N	Datensatzwert für DNS-Validierung
DCVdnsType	String	N	Datensatztyp für DNS-Validierung
DCVfilePath	String	N	Pfad der Datei zur Dateivalidierung
failReason	Object	N	Wird zurückgegeben, wenn Racent bei der Zertifikatsbeantragung bei der CA fehlschlägt und der Fehlergrund eindeutig festgestellt werden kann.
dataReasons	Array	N	Datengründe
key	String	N	Element
reason	String	N	Grund
sysReason	String	N	Systemgrund