2.1 Veri Doğrulama
2.1.1 Arayüz Açıklaması
| Test Ortamı | |
|---|---|
| Gerçek Ortam | https://portal.racent.com/ssl/validate |
| İstek Yöntemi | POST |
| content-type | multipart/form-data |
| Açıklama | Bu 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ü | Zorunlu | Açıklama |
|---|---|---|---|
| api_token | String | Y | Kullanıcı token'ı, token almak için lütfen Racent teknik desteğiyle iletişime geçin |
| productCode | String | Y | Ürün kodu, ürün kodunu edinme (bkz. 2.7) |
| years | Int | Y | Satın alma süresi (şu anda yalnızca 1, 2, 3, 4, 5 desteklenir), belirli ürüne göre değişir. |
| refId | String | N | Müşteri tarafından sağlanan benzersiz müşteri sipariş numarası |
| verificationPic | File | N | Yedek 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. |
| domainVerificationPic | File | N | Alan 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). |
| params | String | Y | Sipariş bilgileri (json dizesi), ayrıntılı açıklaması aşağıda belirtilmiştir |
| csr | String | N | Parametre boş olduğunda, sizin için csr oluşturulur ve özel anahtar saklanır. |
| privateKey | String | N | Özel anahtar. |
| server | String | N | Sunucu. 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. |
| uniqueValue | String | N | Yalnı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). |
| dcvMethod | String | N | Baş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 |
| domainInfo | String | N | Alan 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: |
| dcvMethod | String | N | Alan 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. |
| dcvEmail | String | N | Alan 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 |
| domainName | String | N | Alan adı |
| organizationInfo | String | N | Ş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" }" |
| organizationCity | String | N | Şirketin bulunduğu şehir. |
| organizationName | String | N | Şirket adı. |
| organizationMobile | String | N | Şirket telefonu. |
| organizationAddress | String | N | Şirket adresi. |
| organizationCountry | String | N | Şirketin bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod). |
| organizationPostCode | String | N | Şirketin bulunduğu yerin posta kodu. |
| organizationRegNumber | String | N | Şirket belge numarası. CFCA için bu alan Y'dir. |
| idType | String | N | Ş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 |
| Administrator | string | Y | Yö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": "某公司" }" |
| job | String | Y | Yönetici pozisyonu. |
| city | String | Y | Yöneticinin bulunduğu şehir. |
| String | Y | Yöneticinin e-posta adresi. | |
| state | String | Y | Yöneticinin bulunduğu il veya eyalet. |
| mobile | String | Y | Yönetici iletişim bilgisi. |
| address | String | Y | Yönetici iletişim adresi. |
| country | String | Y | Yöneticinin bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod). |
| lastName | String | Y | Yöneticinin soyadı. |
| postCode | String | Y | Yöneticinin bulunduğu yerin posta kodu. |
| firstName | String | Y | Yönetici adı. |
| organation | String | Y | Yöneticinin şirket adı. |
| idType | String | N | Belge türü. CFCA için bu alan Y'dir. Değerler şunlardır: SFZ: Kimlik kartı HZ: Pasaport |
| idNumber | String | N | Kimlik numarası. CFCA için bu Y'dir. |
| finance | string | Yalnı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": "某公司" }" | |
| job | String | N | Mali işler görevlisi unvanı. |
| city | String | N | Mali işler görevlisinin bulunduğu şehir. |
| String | N | Mali işler görevlisinin e-posta adresi. | |
| state | String | N | Mali işler sorumlusunun bulunduğu eyalet veya il. |
| mobile | String | N | Mali işler sorumlusunun iletişim bilgileri. |
| address | String | N | Mali işler sorumlusunun iletişim adresi. |
| country | String | N | Mali işler sorumlusunun bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod). |
| lastName | String | N | Mali işler sorumlusunun soyadı. |
| postCode | String | N | Mali işler sorumlusunun bulunduğu yerin posta kodu. |
| firstName | String | N | Maliye görevlisinin adı. |
| organation | String | N | Maliye görevlisinin çalıştığı şirket. |
| idType | String | N | Kimlik türü. CFCA için bu alan Y'dir. Değerler şunlardır: SFZ:Kimlik kartı HZ:Pasaport |
| idNumber | String | N | Kimlik numarası. CFCA için bu değer Y'dir. |
| tech | string | N | Yalnı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": "某公司" }" |
| job | String | N | Teknisyen pozisyonu. |
| city | String | N | Teknisyenin bulunduğu şehir. |
| String | N | Teknisyenin e-posta adresi. | |
| state | String | N | Teknisyenin bulunduğu il veya eyalet. |
| mobile | String | N | Teknisyenin iletişim telefonu. |
| address | String | N | Teknisyenin iletişim adresi. |
| country | String | N | Teknisyenin bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod). |
| lastName | String | N | Teknisyenin soyadı. |
| postCode | String | N | Teknisyenin bulunduğu yerin posta kodu. |
| firstName | String | N | Teknisyenin adı. |
| organation | String | N | Teknisyenin bağlı olduğu şirket. |
| idType | String | N | Belge türü. CFCA için bu alan Y'dir. Değerler aşağıdaki gibidir: SFZ: Kimlik Kartı HZ: Pasaport |
| idNumber | String | N | Belge numarası. CFCA için bu alan Y'dir. |
Fonksiyon Dönüşü
| Parametre Adı | Parametre Türü | Zorunlu | Açıklama |
|---|---|---|---|
| code | Int | Y | Dönüş durumu, ayrıntılar için Ek 3.1'e bakınız |
| errors | Object or String | N | Dö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"
}