İlk isteğinizden
çalışan entegrasyona.
Ürün listeleme ile başlayın. Kimlik doğrulamasını yapılandırın ve SSL süreçlerinizi sunucunuzdan yönetin.
Kimlik doğrulama
Temel adres: https://api.sslcipher.com/api/v1
- Bayi panelindeki API Anahtarları bölümünden bir anahtar oluşturun.
- Entegrasyon sunucunuzun çıkış IP adresini anahtarın izin listesine ekleyin.
- Her istekte
X-Api-KeyveX-Api-Secretbaşlıklarını birlikte gönderin. - JSON yanıtlar için
Accept: application/jsonbaşlığını ekleyin.
Gizli anahtarınızı yalnızca sunucu ortam değişkenlerinde veya güvenli gizli bilgi deposunda tutun. Tarayıcı koduna, herkese açık depolara ve günlük kayıtlarına eklemeyin.
Ürünleri listeleyin
Bu salt okunur istek, hesabınıza açık ürünleri döndürür. Anahtarınız ve IP izniniz olmadan yetkili yanıt alınamaz.
curl 'https://api.sslcipher.com/api/v1/products' \
-H "Accept: application/json" \
-H "X-Api-Key: $SSLCIPHER_API_KEY" \
-H "X-Api-Secret: $SSLCIPHER_API_SECRET"<?php
$ch = curl_init('https://api.sslcipher.com/api/v1/products');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Accept: application/json',
'X-Api-Key: ' . getenv('SSLCIPHER_API_KEY'),
'X-Api-Secret: ' . getenv('SSLCIPHER_API_SECRET'),
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status !== 200) {
throw new RuntimeException('API HTTP ' . $status);
}
$products = json_decode($response, true, 512, JSON_THROW_ON_ERROR);// Sunucu tarafında çalıştırın.
const response = await fetch(
'https://api.sslcipher.com/api/v1/products',
{ headers: {
'Accept': 'application/json',
'X-Api-Key': process.env.SSLCIPHER_API_KEY,
'X-Api-Secret': process.env.SSLCIPHER_API_SECRET,
} }
);
if (!response.ok) throw new Error('API HTTP ' + response.status);
const products = await response.json();Yanıt yapısı
Ürün listesi yanıtında data dizisi bulunur. Her üründe id, name, brand, type, is_wildcard, is_multi_domain, max_san ve hesabınıza göre hesaplanan price alanları yer alır. Sipariş oluşturmadan önce güncel ürün detaylarını kontrol edin.
Temel uç noktalar
| Yöntem | Yol | İşlem |
|---|---|---|
| GET | /products | Ürünleri listele |
| GET | /products/{id} | Ürün ve fiyat seçenekleri |
| GET | /orders | Siparişleri listele |
| POST | /orders | Sipariş oluştur |
| GET | /orders/{id} | Sipariş detayını getir |
| GET | /orders/{id}/status | Sipariş durumunu getir |
| POST | /orders/{id}/verify | Doğrulamayı kontrol et |
| POST | /orders/{id}/dcv | Doğrulama yöntemini değiştir |
| POST | /orders/{id}/reissue | Yeniden yayımlama iste |
| GET | /orders/{id}/download/zip | Sertifika arşivini indir |
Yollar temel adrese göre verilmiştir. Yazma işlemlerinin gereken alanları ürüne ve işlemin durumuna bağlıdır. Sipariş entegrasyonunda alan şemalarını destek ekibiyle doğrulayın; bu sayfa başlangıç rehberidir.
Hataları açıkça yönetin
401 YetkisizAnahtar ve gizli anahtarın geçerliliğini kontrol edin.403 Erişim reddiSunucunun IP izin listesinde olduğunu doğrulayın.422 Doğrulama hatasıİstek alanlarını ve dönen hata mesajlarını inceleyin.429 İstek sınırıİstek hızını azaltın; kontrollü yeniden deneme uygulayın.Sipariş gibi yazma işlemlerini bir ağ hatasından sonra körlemesine tekrarlamayın. Önce işlemin oluşup oluşmadığını kontrol edin; aksi halde yinelenen işlemler oluşabilir.