2.21 Başvuru Bilgilerini Düzenle
2.21.1 Api Bilgileri
| Test Ortamı | |
|---|---|
| Gerçek Ortam | https://portal.racent.com/ssl/alter |
| İstek Yöntemi | POST |
| content-type | multipart/form-data |
| Açıklama | Bu arayüz yalnızca CFCA sertifika başvurusu başarısız olduğunda başvuru bilgilerini değiştirmek için kullanılır. |
2.21.2 Parametre Tanımları
| Parametre Adı | Parametre Türü | Zorunlu | Açıklama |
|---|---|---|---|
| api_token | String | Y | Kimlik bilgisi; token oluşturmak için lütfen Racent teknik desteğiyle iletişime geçin. |
| certId | String | Y | racent sertifika kimliği |
| 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 biçimlerini destekler, içerik 2M'ı aşamaz. |
| domainVerificationPic | File | N | Alan adı doğrulama yöntemi VERIFY_DOCUMENT olduğunda bu öğe Y olur. Alan adı sahipliği doğrulaması için kullanılır (şu anda yalnızca CFCA desteklenir). |
| params | String | Y | Sipariş bilgileri; ayrıntılı açıklama aşağıdaki gibidir |
| csr | String | N | Parametre boş olduğunda sizin için csr oluşturulur ve private key saklanır. |
| privateKey | String | N | Private key. |
| server | String | N | Sunucu. Yalnızca SSL sertifikasıyla ilgilidir. SSL sertifikası parametresi Y, diğer ürün türleri parametresi N'dir. Bu parametre gerekmiyorsa varsayılan olarak "other" kullanın. |
| orgCheck | Int | N | Değer 0 veya 1'dir. Değer 1 olduğunda, gönderdiğiniz organizasyon bilgilerine göre hesabınızdaki tüm organizasyonlar sorgulanır; varsa mevcut organizasyonun ilişkili bilgileri kullanılır, yoksa yeni organizasyon olarak kaydederiz. Değer 0 olduğunda organizasyon bilgileri kaydedilmez. |
| duplicateOrgCheck | Int | N | Değer 0 veya 1'dir. Bu parametre şu anda yalnızca Digicert SSL sertifikalarıyla ilgilidir. Daha önce doğrulanmış organizasyon ve alan adı bilgilerinin yeniden kullanılıp kullanılmayacağını belirlemek için kullanılır. Değer 1 olduğunda yeniden kullanılır. Değer 0 olduğunda yeni oluşturulur. Varsayılan 1'dir. |
| 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ı bilgisi, yalnızca SSL sertifikasıyla ilgilidir. SSL sertifikası parametresi için Y, diğer tür parametreleri için N'dir. Standart alan adı toplam sayısı ve joker alan adı toplam sayısı, satın alınan standart alan adı toplam sayısını ve joker alan adı toplam sayısını aşamaz. Ö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ğrulama) HTTP_CSR_HASH(dosya doğrulama) CNAME_CSR_HASH(DNS doğrulama) HTTPS_CSR_HASH(https dosya doğrulama) Ü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 öğe 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 bir ürün sipariş edildiğinde bu parametre Y olur. Örnek aşağıdaki gibidir: { "organizationCity": "Şanghay", "organizationName": "某公司", "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. |
| organizationRegNumbe | String | N | Şirket belge numarası. CFCA için bu alan Y'dir. |
| idType | String | N | Şirket belgesi 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 bilgiler csr oluşturma bilgisi olarak kullanılır. { "job": "Genel Müdürlük Ofisi", "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 unvanı. |
| city | String | Y | Yöneticinin bulunduğu şehir. |
| String | Y | Yöneticinin e-posta adresi. | |
| state | String | Y | Yöneticinin bulunduğu eyalet veya bölge. |
| mobile | String | Y | Yönetici iletişim telefonu. |
| 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öneticinin adı. |
| organation | String | Y | Yöneticinin şirket adı. |
| idType | String | N | Belge türü. CFCA için bu alan Y'dir. Değerler: SFZ: Kimlik kartı HZ: Pasaport |
| idNumber | String | N | Belge numarası. CFCA için bu alan Y'dir. |
| finance | String | Yalnızca SSL sertifikalarıyla ilgilidir. Finans sorumlusu bilgileri. Yönetici bilgileriyle aynı olabilir. Sipariş edilen ürün dv türünde değilse bu parametre Y'dir. { "job": "财务部", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" | |
| job | String | N | Finans sorumlusunun görevi. |
| city | String | N | Finans sorumlusunun bulunduğu şehir. |
| String | N | Finans sorumlusunun e-posta adresi. | |
| state | String | N | Finans sorumlusunun bulunduğu il veya eyalet. |
| mobile | String | N | Finans 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 | Finans görevlisinin bulunduğu yerin posta kodu. |
| firstName | String | N | Finans görevlisinin adı. |
| organation | String | N | Finans görevlisinin çalıştığı şirket. |
| idType | String | N | Kimlik türü. CFCA için bu alan Y'dir. Değerler aşağıdaki gibidir: SFZ: Kimlik kartı HZ: Pasaport |
| idNumber | String | N | Kimlik numarası. CFCA için bu alan Y'dir. |
| tech | String | N | Yalnızca SSL sertifikalarıyla ilgilidir. Teknik sorumlu bilgileri. Sipariş edilen ürün dv türünde değilse bu parametre Y'dir. { "job": "Teknik 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 | Teknisyenin unvanı. |
| 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 bilgileri. |
| 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 çalıştığı ş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üşü
| code | Int | Y | Dönüş durumu, ayrıntılı açıklama için Ek 3.1'e bakınız |
|---|---|---|---|
| errors | Object veya String | N | Dönüş durumu hata olduğunda, belirli hata bilgisi. |
| data | Object | N | Dönüş durumu başarılı olduğunda, bu parametre Y'dir. Belirli açıklama aşağıdaki gibidir: |
| certId | String | N | racent sertifika kimliği. Lütfen iyi saklayın, bu parametre racent örneğinin tek kimliğidir. |
| vendorId | String | N | CA sipariş numarası. |
| vendorCertId | String | N | CA sertifika numarası. |
| DCVfileName | String | N | Dosya doğrulama dosya adı |
| DCVfileContent | String | N | Dosya doğrulama dosya içeriği |
| DCVdnsHost | String | N | DNS doğrulama ana bilgisayar değeri |
| DCVdnsValue | String | N | DNS doğrulama kayıt değeri |
| DCVdnsType | String | N | DNS doğrulama kayıt türü |
| DCVfilePath | String | N | Dosya doğrulama dosya yolu |
| dcvInfo | Object | N | Sertifika başvurusundaki her alan adının doğrulama değeri farklı olduğunda, bu öğe Y'dir Her öğenin türü Object'tir, her öğenin nesne adı başvurulan alan adıdır, örneğin: racent.com. Her öğenin ayrıntıları aşağıdaki gibidir: |
| DCVfileName | String | N | Dosya doğrulama dosya içeriği |
| DCVfileContent | String | N | Dosya doğrulama dosyası içeriği |
| DCVdnsHost | String | N | DNS doğrulama ana bilgisayar değeri |
| DCVdnsValue | String | N | DNS doğrulama kayıt değeri |
| DCVdnsType | String | N | DNS doğrulama kayıt türü |
| DCVfilePath | String | N | Dosya doğrulama dosya yolu |
| failReason | Object | N | Racent CA'ya sertifika başvurusunda başarısız olduğunda ve başarısızlık nedeni netleştiğinde bu öğe döndürülür. |
| dataReasons | Array | N | Veri nedenleri |
| key | String | N | Öğe |
| reason | String | N | Neden |
| sysReason | String | N | Sistem nedeni |