Ana içeriğe geç

2.1 Veri Doğrulama

2.1.1 Arayüz Açıklaması

Test Ortamı
Gerçek Ortamhttps://portal.racent.com/ssl/validate
İstek YöntemiPOST
content-typemultipart/form-data
AçıklamaBu arayüz, ilettiğiniz tüm sipariş verilerini doğrulamak için kullanılır. Siparişin sorunsuz işlenmesini sağlamak için lütfen sipariş arayüzünü çağırmadan önce bu arayüzü çağırın. Bu doğrulama, hesap bilgilerinizi onaylamak ve sipariş bilgilerinizin doğru olduğundan emin olmak için kullanılır; ilgili hata kodlarını döndürür (bkz. Ek 3.1).

2.1.2 Parametre Tanımı

Parametre AdıParametre TürüZorunluAçıklama
api_tokenStringYKullanıcı token'ı, token almak için lütfen Racent teknik desteğiyle iletişime geçin
productCodeStringYÜrün kodu, ürün kodunu edinme (bkz. 2.7)
yearsIntYSatın alma süresi (şu anda yalnızca 1, 2, 3, 4, 5 desteklenir), belirli ürüne göre değişir.
refIdStringNMüşteri tarafından sağlanan benzersiz müşteri sipariş numarası
verificationPicFileNYedek doğrulama materyali. Kuruluş doğrulaması için kullanılır; .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf formatlarını destekler, içerik 2M'yi aşmamalıdır.
domainVerificationPicFileNAlan adı doğrulama yöntemi VERIFY_DOCUMENT olduğunda bu alan Y olur. Alan adı sahipliği doğrulaması için kullanılır (şu anda yalnızca CFCA desteklenir).
paramsStringYSipariş bilgileri (json dizesi), ayrıntılı açıklaması aşağıda belirtilmiştir
csrStringNParametre boş olduğunda, sizin için csr oluşturulur ve özel anahtar saklanır.
privateKeyStringNÖzel anahtar.
serverStringNSunucu. Yalnızca SSL sertifikalarıyla ilgilidir. SSL sertifikası parametresi Y, diğer ürün türleri parametresi N'dir. Bu parametre gerekmiyorsa, varsayılan olarak "other" kullanın.
uniqueValueStringNYalnızca Sectigo ürünleriyle ilgilidir. Distribütörün doğrulama değerini kendi oluşturması için 1-20 karakter (a-z A-Z 0-9).
dcvMethodStringNBaşvuru alan adı doğrulama yöntemini birleşik olarak ayarlar.
Aşağıdaki dört yöntemden biri olmalıdır:
EMAIL (e-posta doğrulama)
HTTP_CSR_HASH (dosya doğrulama)
CNAME_CSR_HASH (DNS doğrulama)
HTTPS_CSR_HASH (https dosya doğrulama)
VERIFY_DOCUMENT (alan adı sertifika kanıtı, yalnızca CFCA'yı destekler)
CFCA için bu öğe Y'dir
domainInfoStringNAlan adı bilgileri, yalnızca SSL sertifikasıyla ilgilidir. SSL sertifikası parametresi için Y, diğer tür parametreler için N'dir.
Örnek:
[
{ "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"
}
]
Ayrıntılı açıklama aşağıdaki gibidir:
dcvMethodStringNAlan adı doğrulama yöntemi.
Aşağıdaki dört yöntemden biri olmalıdır:
EMAIL(e-posta doğrulaması)
HTTP_CSR_HASH(dosya doğrulaması)
CNAME_CSR_HASH(DNS doğrulaması)
HTTPS_CSR_HASH(https dosya doğrulaması)
Üst düzey dcvMethod mevcut olmadığında bu öğe Y'dir.
Üst düzey dcvMethod mevcut olduğunda ve bu öğe de mevcutsa, üst düzey dcvMethod öncelikli olarak kullanılır.
dcvEmailStringNAlan adı doğrulama e-postası.
Bu alan N olduğunda, varsayılan durum aşağıdaki gibidir
racent.com : admin@racent.com
www.racent.com : admin@racent.com
*.racent.com : admin@racent.com
domainNameStringNAlan adı
organizationInfoStringNŞirket bilgileri. Kurumsal doğrulama gerektiren ürünler sipariş edildiğinde bu parametre Y olur. Örnek aşağıdaki gibidir:
{
"organizationCity": "Şanghay",
"organizationName": "Örnek Şirket",
"organizationMobile": "18111111111",
"organizationAddress": "Şanghay Yolu",
"organizationCountry": "CN",
"organizationPostCode": "401320"
}"
organizationCityStringNŞirketin bulunduğu şehir.
organizationNameStringNŞirket adı.
organizationMobileStringNŞirket telefonu.
organizationAddressStringNŞirket adresi.
organizationCountryStringNŞirketin bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod).
organizationPostCodeStringNŞirketin bulunduğu yerin posta kodu.
organizationRegNumberStringNŞirket belge numarası. CFCA için bu alan Y'dir.
idTypeStringNŞirket belge türü. CFCA için bu alan Y'dir.
Değerler aşağıdaki gibidir:
TYDMZ: Birleşik Sosyal Kredi Kodu
OTHERS: Diğer
AdministratorstringYYönetici bilgileri, iletişim kişisi. Kod imzalama, e-posta imzalama veya belge imzalama başvurusu yapılırken bu parametre başvuru bilgisi olarak kullanılır. Ayrıca csr N ise bu bilgi, csr üretim bilgisi olarak kullanılır.
{
"job": "Genel Müdürlük",
"city": "Şanghay",
"email": "xx@yy.com",
"state": "Şanghay",
"mobile": "18111111111",
"address": "Şanghay",
"country": "CN",
"lastName": "zhang",
"postCode": "401320",
"firstName": "nick",
"organation": "某公司"
}"
jobStringYYönetici pozisyonu.
cityStringYYöneticinin bulunduğu şehir.
emailStringYYöneticinin e-posta adresi.
stateStringYYöneticinin bulunduğu il veya eyalet.
mobileStringYYönetici iletişim bilgisi.
addressStringYYönetici iletişim adresi.
countryStringYYöneticinin bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod).
lastNameStringYYöneticinin soyadı.
postCodeStringYYöneticinin bulunduğu yerin posta kodu.
firstNameStringYYönetici adı.
organationStringYYöneticinin şirket adı.
idTypeStringNBelge türü. CFCA için bu alan Y'dir.
Değerler şunlardır:
SFZ: Kimlik kartı
HZ: Pasaport
idNumberStringNKimlik numarası. CFCA için bu Y'dir.
financestringYalnızca SSL sertifikalarıyla ilgilidir.
Finans personeli bilgileri. Yönetici bilgileriyle aynı olabilir. Sipariş edilen ürün dv türünde olmadığında bu parametre Y'dir.
{
"job": "Finans Departmanı",
"city": "Şanghay",
"email": "xx@yy.com",
"state": "Şanghay",
"mobile": "18111111111",
"address": "Şanghay",
"country": "CN",
"lastName": "zhang",
"postCode": "401320",
"firstName": "nick",
"organation": "某公司"
}"
jobStringNMali işler görevlisi unvanı.
cityStringNMali işler görevlisinin bulunduğu şehir.
emailStringNMali işler görevlisinin e-posta adresi.
stateStringNMali işler sorumlusunun bulunduğu eyalet veya il.
mobileStringNMali işler sorumlusunun iletişim bilgileri.
addressStringNMali işler sorumlusunun iletişim adresi.
countryStringNMali işler sorumlusunun bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod).
lastNameStringNMali işler sorumlusunun soyadı.
postCodeStringNMali işler sorumlusunun bulunduğu yerin posta kodu.
firstNameStringNMaliye görevlisinin adı.
organationStringNMaliye görevlisinin çalıştığı şirket.
idTypeStringNKimlik türü. CFCA için bu alan Y'dir.
Değerler şunlardır:
SFZ:Kimlik kartı
HZ:Pasaport
idNumberStringNKimlik numarası. CFCA için bu değer Y'dir.
techstringNYalnızca SSL sertifikasıyla ilgilidir.
Teknisyen bilgileri. Sipariş edilen ürün dv türünde olmadığında bu parametre Y'dir.
{
"job": "Teknoloji Departmanı","city": "Şanghay",
"email": "xx@yy.com",
"state": "Şanghay",
"mobile": "18111111111",
"address": "Şanghay",
"country": "CN",
"lastName": "zhang",
"postCode": "401320",
"firstName": "nick",
"organation": "某公司"
}"
jobStringNTeknisyen pozisyonu.
cityStringNTeknisyenin bulunduğu şehir.
emailStringNTeknisyenin e-posta adresi.
stateStringNTeknisyenin bulunduğu il veya eyalet.
mobileStringNTeknisyenin iletişim telefonu.
addressStringNTeknisyenin iletişim adresi.
countryStringNTeknisyenin bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod).
lastNameStringNTeknisyenin soyadı.
postCodeStringNTeknisyenin bulunduğu yerin posta kodu.
firstNameStringNTeknisyenin adı.
organationStringNTeknisyenin bağlı olduğu şirket.
idTypeStringNBelge türü. CFCA için bu alan Y'dir.
Değerler aşağıdaki gibidir:
SFZ: Kimlik Kartı
HZ: Pasaport
idNumberStringNBelge numarası. CFCA için bu alan Y'dir.

Fonksiyon Dönüşü

Parametre AdıParametre TürüZorunluAçıklama
codeIntYDönüş durumu, ayrıntılar için Ek 3.1'e bakınız
errorsObject or StringNDönüş durumu hata olduğunda hata bilgisi.

2.1.3 İstek Örneği

请求示例

{
"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"
}