2.10 SSL Aboneliği Yenileme
2.10.1 Api Bilgileri
| Test Ortamı | |
|---|---|
| Gerçek Ortam | https://portal.racent.com/ssl/renew |
| İstek Yöntemi | POST |
| content-type | multipart/form-data |
| Açıklama | Bu arayüz, SSL aboneliklerini yenilemek için kullanılır. Yalnızca SSL abonelik durumu "Düzenlendi" olan ve 30 gün içinde süresi dolacak aboneliklerin yenilenmesine izin verilir. |
2.10.2 Parametre Tanımı
| 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. |
| renewId | String | Y | racent sertifika kimliği |
| years | Int | Y | Yenileme 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'ı aşmamalıdır. |
| domainVerificationPic | File | N | Alan adı doğrulama yöntemi: VERIFY_DOCUMENT olduğunda bu öğe Y'dir. 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ğıdadır |
| 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 sertifikasıyla ilgilidir. SSL sertifikası parametresi Y'dir; diğer ürün türlerinde parametre 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 kuruluş bilgisine göre hesabınızdaki tüm kuruluşlar taranır; varsa mevcut kuruluşun ilişkili bilgileri kullanılır, yoksa yeni kuruluş olarak kaydedilir. Değer 0 olduğunda kuruluş bilgisi 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ış kuruluş 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. |
| uniqueValue | String | N | Yalnızca Sectigo ürünleriyle ilgilidir. Bayilerin doğrulama değerini kendilerinin oluşturması için 1-20 karakter (a-z A-Z 0-9). |
| dcvMethod | String | N | Başvurulan alan adının doğrulama yöntemini tek tip 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 Y, diğer tür parametreleri N'dir. CFCA için bu öğe 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ı) |
| dcvEmail | String | N | Alan adı doğrulama e-postası. Doğrulama yöntemi EMAIL olduğunda bu alan Y olur. |
| domainName | String | N | Alan adı |
| organizationInfo | String | N | Şirket bilgisi. Kurumsal doğrulama gerektiren ürünler sipariş edildiğinde bu parametre Y olur. CFCA için bu parametre N'dir. Örnek aşağıdaki gibidir: { "organizationCity": "上海", "organizationName": "某公司", "organizationMobile": "18111111111", "organizationAddress": "上海市路", "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. |
| 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 oluşturma bilgisi olarak kullanılır. CFCA için bu alan N'dir. { "job": "总经办", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "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 eyalet veya il. |
| mobile | String | Y | Yönetici iletişim bilgileri. |
| 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önetici şirket adı. |
| finance | String | Yalnızca SSL sertifikalarıyla ilgilidir. Mali personel bilgileri. Yönetici bilgileriyle aynı olabilir. Sipariş edilen ürün dv türünde olmadığında bu parametre Y'dir. CFCA için bu öğe N'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": "Örnek Şirket" }" | |
| job | String | N | Mali işler görevlisi pozisyonu. |
| 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 sorumlunun bulunduğu ülke (ISO 3166-1 standardındaki iki harfli kod). |
| lastName | String | N | Mali sorumlunun soyadı. |
| postCode | String | N | Mali sorumlunun bulunduğu yerin posta kodu. |
| firstName | String | N | Finans görevlisinin adı. |
| organation | String | N | Finans görevlisinin çalıştığı şirket. |
| tech | String | N | Yalnızca SSL sertifikalarıyla ilgilidir. Teknik personel bilgisi. Sipariş edilen ürün dv türünde olmadığında bu parametre Y'dir. CFCA için bu öğe N'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 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 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. |
Fonksiyon Dönüşü
| Parametre Adı | Parametre Türü | Zorunlu | Açıklama |
|---|---|---|---|
| code | Int | Y | Dönüş durumu, ayrıntılı açıklama için Ek 3.1'e bakın |
| errors | Object or 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 olur Her öğenin türü Object'tir; her öğe nesnesinin 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 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 dosyası yolu |