Faydalı sitelerin çoğu dış servislere yaslanır: biri kartla ödemeyi alır, biri SMS gönderir, biri haritayı çizer ya da e-postayı iletir. Bunlara bir API üzerinden bağlanırsınız.
Bağlanmak sohbette anlatması kolay bir iştir; güvenle bağlanmak ise birkaç alışkanlık ister. Aşağıda.
API, sitenizin ödeme, SMS veya harita gibi başka bir servisle konuşmasını sağlar. Anahtarları proje gizli anahtarı olarak saklayın, servisi yalnızca sunucu tarafından çağırın ve her webhook'u güvenmeden önce doğrulayın.
API anahtarı nedir, nereye asla konmaz
API anahtarı, o servisteki hesabınızın şifresi gibidir. Elinde bulunduran paranızı harcayabilir veya verinizi okuyabilir; bu yüzden sohbette, sayfanın ön yüz kodunda veya herkese açık bir GitHub deposunda asla yer almamalıdır.
Anahtarları proje gizli anahtarı olarak saklayın, sunucu okusun. Bir anahtar sızarsa hemen sağlayıcıdan iptal edip yenisini oluşturun.
Dış servisleri sunucudan çağırın
Ziyaretçinin tarayıcısında çalışan her şey incelenebilir. Bu yüzden gizli anahtarı kullanan çağrı sunucunuzda yapılmalıdır: tarayıcı sunucunuza sorar, sunucunuz servise sorar.
Bazı anahtarlar zaten herkese açık olacak şekilde tasarlanmıştır, genelde yayımlanabilir anahtar denir ve tarayıcıda güvenlidir. Hangisine sahip olduğunuzu sağlayıcının belgelerinden öğrenin.
- Önce sağlayıcının test modunu ve test anahtarlarını kullanın.
- Hataları yönetin: servis çökerse nazik bir mesaj gösterin.
- İstek sınırlarına uyun ki engellenmeyin.
Webhook: bu kez servis sizi arar
Webhook ters yöndür: ödeme başarılı olunca sağlayıcı sitenizdeki bir adrese mesaj gönderir. Siparişin gerçekten ödendiğini sitenize bu haber verir.
O adrese herkes sahte mesaj atabileceği için, sağlayıcının eklediği imzayı güvenle sakladığınız bir sır ile doğrulayın. Aynı mesajın iki kez gelmesini de ikinci bir sipariş oluşturmadan karşılayın.
Maliyet, sınır ve yerel kurallar
Birçok entegrasyon ücretlidir ya da sınırlı bir ücretsiz katmanı vardır. Ödeme, SMS ve bazı harita veya yapay zeka servisleri kullanıma göre ücret alır; bunlar sağlayıcının kendi fiyatlarıdır ve sitenizin yapım sürecinden ayrıdır. Yayına almadan kontrol edin. Türkiye'de ödeme için yerel kartları ve taksiti destekleyen bir sağlayıcı gerekebilir.
Servis müşterilerinizin kişisel verisini alıyorsa nerede işlendiğini öğrenin ve gizlilik politikanızda belirtin. Bu genel bilgidir, hukuki tavsiye değildir.
Kopyalayıp kullanabileceğiniz istem
“Randevu sitemi onay mesajı göndermek için bir SMS sağlayıcıya bağla. Sağlayıcı anahtarını proje gizli anahtarından oku, yalnızca sunucudan çağır, test modu anahtarı ekle ve gönderim başarısız olursa nazik bir hata göster. Anahtarı gizli anahtar olarak kendim ekleyeceğim.”