SSL sertifika API'si, sertifika sipariş etmek, doğrulamak, indirmek ve yenilemek için web panelinde tıklamak yerine HTTP istekleri gönderebilmenizi sağlar. Çok sayıda alan adı yönetenler ve hosting/otomasyon sağlayıcıları için zaman kazandırır.
Temel mantık
Çoğu API REST tarzındadır: bir temel adrese (base URL) kimlik bilgisiyle HTTPS isteği atılır, yanıt JSON döner. Tipik akış şöyledir:
- Kimlik doğrulama (API anahtarı ya da kullanıcı adı/parola ile token alma)
- Ürün listesini ve fiyatı sorgulama
- CSR ile sipariş oluşturma
- Alan adı doğrulamasını (DCV) başlatma
- Durum sorgulayıp sertifikayı indirme
Örnek istek yapısı
curl -X POST "https://api.ornek-ca.example/v1/orders" \
-H "Authorization: Bearer $API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"product_id": 1, "period": 12, "csr": "-----BEGIN CERTIFICATE REQUEST-----..."}'Adres ve alan adları sağlayıcıya göre değişir; yukarıdaki yalnızca şemayı gösteren kurgusal bir örnektir. Gerçek uç noktalar için ilgili sağlayıcının dokümanına bakın.
Ne zaman API kullanmalı?
- Onlarca alan adının sertifikasını düzenli yenilemeniz gerekiyorsa
- Kendi panelinize ya da hosting sisteminize sertifika satışı eklemek istiyorsanız
- Bitiş tarihlerini otomatik izleyip uyarı üretmek istiyorsanız
Dikkat edilecekler
- API anahtarını kaynak koduna gömmeyin; ortam değişkeni veya gizli yönetici kullanın.
- Önce varsa test (sandbox) ortamında deneyin.
- Hata ve zaman aşımı durumları için yeniden deneme mantığı ekleyin.
Özel anahtar üretimi her zaman kendi sunucunuzda kalmalıdır; API'ye yalnızca CSR gönderilir. CSR'ı hazırlamak için CSR oluşturucu, ürünleri incelemek için SSL sertifikaları sayfasına bakabilirsiniz. Bayi API'si konusunda Türkçe teknik destek ekibimize yazabilirsiniz.
Başlangıç için öneri
İlk entegrasyonda yalnızca salt okunur çağrılarla (ürün ve sipariş listesi) başlayın, ardından tek bir DV siparişiyle tüm zinciri deneyin. Sipariş, doğrulama ve indirme adımlarını ayrı fonksiyonlara bölmek, hata olduğunda hangi aşamada kaldığınızı görmenizi kolaylaştırır. Yanıtları ve sipariş kimliklerini kendi veritabanınızda saklayın; böylece API geçici olarak erişilemezse bile müşteriye durum gösterebilirsiniz.