2.3 Sertifika Başvuru Durumunu Sorgulama
2.3.1 Api Bilgileri
| Test Ortamı | |
|---|---|
| Gerçek Ortam | https://portal.racent.com/ssl/collect |
| İstek Yöntemi | POST |
| content-type | multipart/form-data |
| Açıklama | Bu arayüz, sipariş edilen sertifika durumunu almak, sertifikayı almak ve doğrulama bilgilerini almak için kullanılır. |
2.3.2 Parametre Tanımları
| Parametre Adı | Parametre Türü | Zorunlu | Açıklama |
|---|---|---|---|
| certId | String | Y | racent sertifika kimliği |
| api_token | String | Y | Kimlik bilgisi, token oluşturmak için lütfen Racent teknik desteğiyle iletişime geçin. |
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 |
| status | String | Y | Sipariş durumu: PENDING:Başvuruda COMPLETE:Başvuru başarılı CANCELLED:İptal edildi REISSUED:Yeniden imzalandı FAILED:Başvuru başarısız RENEWED:Yenilendi REVOKED:İptal edildi |
| certStatus | String | Y | Sertifika durumu: PENDING:Başvuruda COMPLETE:Başvuru başarılı CANCELLED:İptal edildi REISSUED:Yeniden imzalandı FAILED:Başvuru başarısız RENEWED:Yenilendi REVOKED:İptal edildi |
| data | Object | N | Döndürülen veri, ayrıntılar aşağıdadır |
| failReason | Object | N | Durum FAILED olduğunda bu parametre Y olur, başarısızlık nedeni |
| dataReasons | Array | N | Veri nedenleri |
| key | String | N | Öğe |
| reason | String | N | Neden |
| sysReason | String | N | Sistem nedeni |
| beginDate | String | N | Durum COMPLETE olduğunda bu parametre Y olur, sertifika başlangıç zamanı |
| endDate | String | N | Durum COMPLETE olduğunda bu parametre Y olur, sertifika bitiş zamanı |
| certificate | String | N | Durum COMPLETE olduğunda bu parametre Y olur, pem sertifikası |
| caCertificate | String | N | Durum COMPLETE olduğunda, bu parametre Y'dir, pem ara sertifika |
| jks | String | N | Durum COMPLETE olduğunda ve racent doğru özel anahtar bilgisine sahip olduğunda, bu parametre Y'dir, jks sertifika içeriğinin base64 kodlaması. |
| jksPass | String | N | Durum COMPLETE olduğunda ve racent doğru özel anahtar bilgisine sahip olduğunda, bu parametre Y'dir, jks sertifika şifresi. |
| pkcs12 | String | N | Durum COMPLETE olduğunda ve racent doğru özel anahtar bilgisine sahip olduğunda, bu parametre Y'dir, PKCS12 sertifika içeriğinin base64 kodlaması. |
| pkcsPass | String | N | Durum COMPLETE olduğunda ve racent doğru özel anahtar bilgisine sahip olduğunda, bu parametre Y'dir, PKCS12 sertifika şifresi. |
| privateKey | String | N | Durum COMPLETE olduğunda ve racent doğru özel anahtar bilgisine sahip olduğunda, bu parametre Y'dir, özel anahtar bilgisi |
| rsaPrivateKey | String | N | rsa biçiminde özel anahtar, durum COMPLETE olduğunda ve racent doğru özel anahtar bilgisine sahip olduğunda, bu parametre Y'dir, özel anahtar bilgisi |
| replaceCertId | String | N | Durum REISSUED olduğunda, bu parametre Y'dir, yeniden imzalanan racent sertifika kimliği |
| oldCertId | String | N | Sertifika başvurusu yeniden imzalama olduğunda, bu parametre Y'dir, eski racent sertifika kimliği |
| vendorId | String | N | CA sipariş numarası |
| vendorCertId | String | N | CA sertifika numarası (sectigo sipariş numarası) |
| DCVfileName | String | N | Alan adı dosya doğrulaması, dosya adı |
| DCVfileContent | String | N | Dosya doğrulaması, dosya içeriği |
| DCVdnsHost | String | N | DNS doğrulaması, host |
| DCVdnsValue | String | N | DNS doğrulaması value |
| DCVdnsType | String | N | DNS doğrulaması type |
| dcvInfo | Object | N | Sertifika başvurusundaki her alan adının doğrulama değeri farklı olduğunda bu alan Y olur Her öğe Object türündedir, her nesne adı başvurulan alan adıdır, örn: racent.com. Her öğenin ayrıntıları aşağıdaki gibidir: |
| DCVfileName | String | N | Alan adı dosya doğrulaması, dosya adı |
| DCVfileContent | String | N | Dosya doğrulama, dosya içeriği |
| DCVdnsHost | String | N | DNS doğrulama, host |
| DCVdnsValue | String | N | DNS doğrulama value |
| DCVdnsType | String | N | DNS doğrulama type |
| DCVfilePath | String | N | Dosya doğrulama dosya yolu |
| dcvList | Array | N | Alan adı doğrulama listesi, her öğe Object türündedir, her öğenin ayrıntıları aşağıdaki gibidir: |
| domainName | String | N | Alan adı |
| dcvMethod | String | N | Alan adı doğrulama yöntemi |
| dcvEmail | String | N | Alan adı doğrulama e-postası |
| is_verify | String | N | Doğrulanmış parametre değeri “verified” olur, doğrulanmamışsa parametre yoktur |
| application | Object | N | Sipariş gönderim durumu |
| status | String | N | Parametre şu değerlerden biridir: notdone: tamamlanmadı done: tamamlandı ongoing: devam ediyor |
| dcv | Object | N | Alan adı doğrulama durumu |
| status | String | N | Parametre şu değerlerden biridir: notdone: tamamlanmadı done: tamamlandı ongoing: devam ediyor |
| ov | Object | N | Kuruluş doğrulama durumu |
| status | String | N | Parametre şu değerlerden biridir: notdone: tamamlanmadı done: tamamlandı ongoing: devam ediyor |
| issued | Object | N | Sertifika verme durumu |
| status | String | N | Parametre şu değerlerden biridir: notdone: tamamlanmadı done: tamamlandı ongoing: devam ediyor |
| applyParams | Object | N | Başvuru parametreleri, ayrıntılar için başvuru arayüzü (place) istek parametrelerine bakın |
| csr | String | N | csr |
| Administrator | Object | N | Yönetici bilgileri |
| job | String | N | Pozisyon |
| city | String | N | Şehir |
| String | N | E-posta | |
| state | String | N | Eyalet veya bölge |
| mobile | String | N | İletişim bilgisi |
| address | String | N | İletişim adresi |
| country | String | N | Ülke (ISO 3166-1 standardında iki harfli kod). |
| lastName | String | N | Soyadı |
| postCode | String | N | Posta kodu |
| firstName | String | N | Ad |
| organation | String | N | Ş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 | Belge numarası. CFCA için bu alan Y'dir. |
| tech | Object | N | Teknik personel bilgileri; alt alanlar yönetici bilgileriyle aynıdır |
| finance | Object | N | Mali işler personeli bilgileri; alt alanlar yönetici bilgileriyle aynıdır |
| organizationInfo | Object | N | Şirket bilgileri |
| organizationCity | String | N | Şehir |
| organizationName | String | N | Ad |
| organizationMobile | String | N | Telefon |
| organizationAddress | String | N | Adres |
| organizationCountry | String | N | Ülke |
| organizationPostCode | String | N | Posta kodu |
| organizationRegNumbe | 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 |
| errors | Object veya String | N | Dönüş durumu hata olduğunda, belirli hata bilgisi. |