2.1 Daten validieren

2.1.1 Schnittstellenbeschreibung

Testumgebung
Produktivumgebung	https://portal.racent.com/ssl/validate
Anfragemethode	POST
content-type	multipart/form-data
Beschreibung	Diese Schnittstelle dient dazu, alle von Ihnen übermittelten Bestelldaten zu validieren. Bitte rufen Sie diese Schnittstelle vor der Bestellschnittstelle auf, um eine reibungslose Auftragsabwicklung sicherzustellen. Diese Validierung dient zur Bestätigung Ihrer Kontoinformationen sowie zur Sicherstellung, dass Ihre Bestellinformationen korrekt sind, und gibt die entsprechenden Fehlercodes zurück (siehe Anhang 3.1).

2.1.2 Parameterdefinitionen

Parametername	Parametertyp	Pflicht	Beschreibung
api_token	String	Y	Benutzer-Token. Zur Beschaffung des Tokens wenden Sie sich bitte an den technischen Support von Racent.
productCode	String	Y	Produktcode. Zur Beschaffung des Produktcodes (siehe 2.7).
years	Int	Y	Kaufzeitraum in Jahren (derzeit werden nur 1, 2, 3, 4, 5 unterstützt), abhängig vom konkreten Produkt.
refId	String	N	Eindeutige Kundenbestellnummer, die vom Kunden bereitgestellt wird
verificationPic	File	N	Zusätzliches Verifizierungsmaterial. Für die Organisationsvalidierung, unterstützte Formate: .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf, Dateigröße maximal 2 MB.
domainVerificationPic	File	N	Wenn die Methode zur Domain-Validierung 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 (JSON-Zeichenfolge), Einzelheiten siehe unten
csr	String	N	Wenn der Parameter leer ist, wird eine CSR für Sie generiert und der private Schlüssel gespeichert.
privateKey	String	N	Privater Schlüssel.
server	String	N	Server. Nur mit SSL-Zertifikaten verbunden. Für SSL-Zertifikatsparameter ist Y, für andere Produkttypen ist der Parameter N. Wenn dieser Parameter nicht benötigt wird, verwenden Sie bitte standardmäßig „other“.
uniqueValue	String	N	Nur mit Sectigo-Produkten verbunden. 1–20 Zeichen (a–z A–Z 0–9) für die eigenständige Generierung des Verifizierungswerts durch den Distributor.
dcvMethod	String	N	Legt einheitlich die Verifizierungsmethode für die beantragte Domain fest. Muss eine der folgenden vier Methoden sein: EMAIL (E-Mail-Verifizierung) HTTP_CSR_HASH (Dateiverifizierung) CNAME_CSR_HASH (DNS-Verifizierung) HTTPS_CSR_HASH (HTTPS-Dateiverifizierung) VERIFY_DOCUMENT (Domain-Zertifikatsnachweis, nur CFCA unterstützt) Für CFCA ist dieser Wert Y
domainInfo	String	N	Domäneninformationen, nur im Zusammenhang mit SSL-Zertifikaten. Bei SSL-Zertifikatsparametern ist der Wert Y, bei anderen Parametertypen 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" } ] Die spezifische Beschreibung ist wie folgt:
dcvMethod	String	N	Methode zur Domänenvalidierung. 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, wird die übergeordnete dcvMethod bevorzugt verwendet.
dcvEmail	String	N	E-Mail für die Domain-Validierung. Wenn dieser Wert N ist, gelten standardmäßig folgende Angaben: racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com
domainName	String	N	Domain
organizationInfo	String	N	Unternehmensinformationen. Bei Bestellung von Produkten, die eine Unternehmensvalidierung erfordern, ist dieser Parameter Y. Beispiel: { "organizationCity": "Shanghai", "organizationName": "Ein Unternehmen", "organizationMobile": "18111111111", "organizationAddress": "Straße in Shanghai", "organizationCountry": "CN", "organizationPostCode": "401320" }"
organizationCity	String	N	Stadt, in der sich das Unternehmen befindet.
organizationName	String	N	Name des Unternehmens.
organizationMobile	String	N	Telefonnummer des Unternehmens.
organizationAddress	String	N	Firmenadresse.
organizationCountry	String	N	Land des Unternehmens (zweistelliger Code gemäß ISO 3166-1).
organizationPostCode	String	N	Postleitzahl des Unternehmensstandorts.
organizationRegNumber	String	N	Firmenregistrierungsnummer. Bei CFCA ist dieses Feld Y.
idType	String	N	Art des Firmenausweises. Bei CFCA ist dieses Feld Y. Werte wie folgt: TYDMZ: Einheitlicher Sozialkreditcode OTHERS: Sonstige
Administrator	string	Y	Administratorinformationen, Kontaktperson. Bei der Beantragung von Code-Signatur-, E-Mail-Signatur- oder Dokumentensignatur-Zertifikaten dient dieser Parameter als Antragsinformation. Wenn csr außerdem N ist, dienen diese Informationen als Generierungsinformationen für die CSR. { "job": "总经办", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }"
job	String	Y	Position des Administrators.
city	String	Y	Stadt des Administrators.
email	String	Y	E-Mail des Administrators.
state	String	Y	Provinz oder Bundesland, in dem sich der Administrator befindet.
mobile	String	Y	Kontaktinformationen 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.
idType	String	N	Art des Ausweisdokuments. Bei CFCA ist dieses Feld Y. Werte wie folgt: SFZ: Personalausweis HZ: Reisepass
idNumber	String	N	Ausweisnummer. Für CFCA ist dieses Feld Y.
finance	string		Nur im Zusammenhang mit SSL-Zertifikaten. Informationen zur Finanzabteilung. Können 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 des Finanzmitarbeiters.
city	String	N	Stadt des Finanzmitarbeiters.
email	String	N	E-Mail des Finanzmitarbeiters.
state	String	N	Bundesland oder Staat des Finanzverantwortlichen.
mobile	String	N	Kontaktmöglichkeit des Finanzverantwortlichen.
address	String	N	Kontaktadresse des Finanzverantwortlichen.
country	String	N	Land des Finanzverantwortlichen (Zweibuchstabencode nach ISO 3166-1).
lastName	String	N	Nachname des Finanzverantwortlichen.
postCode	String	N	Postleitzahl des Standorts des Finanzverantwortlichen.
firstName	String	N	Name des Finanzverantwortlichen.
organation	String	N	Unternehmen des Finanzverantwortlichen.
idType	String	N	Art des Ausweisdokuments. Bei CFCA ist dieses Feld Y. Mögliche Werte: SFZ: Personalausweis HZ: Reisepass
idNumber	String	N	Ausweisnummer. Bei CFCA ist dieses Feld Y.
tech	string	N	Nur für SSL-Zertifikate relevant. Informationen zum Techniker. Wenn das bestellte Produkt kein DV-Typ 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 des Technikers.
mobile	String	N	Kontakttelefonnummer des Technikers.
address	String	N	Kontaktadresse des Technikers.
country	String	N	Land des Technikers (zweistelliger Code gemäß ISO 3166-1).
lastName	String	N	Nachname des Technikers.
postCode	String	N	Postleitzahl des Standorts des Technikers.
firstName	String	N	Vorname 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ückgabewerte der Funktion

Parametername	Parametertyp	Erforderlich	Beschreibung
code	Int	Y	Rückgabestatus, Details siehe Anhang 3.1
errors	Object oder String	N	Fehlerinformation, wenn der Rückgabestatus Fehler anzeigt.

2.1.3 Anfragebeispiel

请求示例

{
	"years": 2,
	"params": ‘{"server":"iis7","csr":"-----BEGIN CERTIFICATE REQUEST-----\nxxxxxxyyyoo\n-----END CERTIFICATE REQUEST-----\n","domainInfo":[{"domainName":"tt.cn","dcvMethod":"HTTP_CSR_HASH","dcvEmail":""}],"Administrator":{"organation":"cola","job":"it","firstName":"nick","lastName":"zhang","email":"xx@tt.com.cn","mobile":"13911111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4457145"},"finance":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"18111111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4514154"},"tech":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"15122222222","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"48787"},"organizationInfo":{"organizationCity":"上海","organizationState":"上海","organizationMobile":"153999999999","organizationAddress":"上海某地","organizationCountry":"CN","organizationPostCode":"200233","organizationName":"个人"}}’,
	"api_token": "zzzoooppzz",
	"productCode": "comodo-positivessl"
}