GoGetSSL, SSL sertifikalarını bayilere REST tabanlı bir API üzerinden sunar. Bu rehber, tipik bir entegrasyonun sırasını ve dikkat edilecek noktaları özetler; kesin uç nokta ve parametre adları için her zaman güncel GoGetSSL API dokümanını esas alın.
Kimlik doğrulama
İstekler, bayi hesabınızın kullanıcı adı ve parolası ile alınan bir oturum anahtarı (auth key) ile yapılır. Bu anahtar süreli olabilir; geçersiz hale geldiğinde istekler "Auth key is not valid" türünde bir hata döndürür. Bu durumda yeniden kimlik doğrulama yapıp anahtarı yenilemeniz gerekir. Anahtarı kalıcı saklamak yerine gerektiğinde yenileyen bir yapı kurmak daha sağlamdır.
Tipik sipariş akışı
- Ürün listesi ve fiyatlar sorgulanır.
- CSR ve yönetici e-postası veya DCV yöntemi ile sipariş oluşturulur.
- Alan adı doğrulaması tamamlanır (e-posta, DNS ya da HTTP dosya).
- Sipariş durumu sorgulanır; sertifika yayınlanınca içerik alınır.
Yanıtları doğru okumak
- Başarı alanı bazen sayı (1), bazen boolean gelebilir; kontrolü esnek yapın.
- Hata durumunda açıklama metni ayrı bir alanda döner; kullanıcıya ham hatayı değil anlaşılır bir mesaj gösterin.
- Durumu sık sorgulamak yerine makul aralıklarla (örneğin birkaç dakikada bir) kontrol edin.
Sık karşılaşılan sorunlar
- Geçersiz CSR: CN ve SAN alanlarının sipariş edilen alan adıyla uyumlu olduğunu kontrol edin.
- Doğrulama bekliyor: DCV kaydının yayılmasını bekleyin ve doğru yöntemi seçtiğinizden emin olun.
- Bakiye yetersiz: Bayi bakiyesi olmadan sipariş tamamlanmaz.
Test aşamasında önce küçük bir DV siparişiyle akışı doğrulayın. CSR üretimi için CSR oluşturucuyu, yayınlanan sertifikanın doğru kurulduğunu görmek için SSL denetleyiciyi kullanabilirsiniz.
Entegrasyon önerileri
- Kimlik doğrulama çağrısını tek bir yardımcı fonksiyonda toplayın; anahtar geçersiz olursa bu fonksiyon otomatik yenileyip isteği bir kez tekrar etsin.
- Sipariş kimliğini aldığınız anda kaydedin; çift sipariş riskini azaltır.
- Ham yanıtları iç günlükte tutun, böylece beklenmeyen bir alan geldiğinde hızlıca inceleyebilirsiniz.