Kimlik doğrulama ve güvenlik
API anahtarları
Anahtarınızı her istekte Authorization başlığıyla gönderin:
Authorization: Bearer pxt_test_1a2B3c4D5e6F7g8H9i0J1k2L3m4N5o6P7q8R9s0T| Önek | Ortam | Ne yapar |
|---|---|---|
pxt_test_ | Test | Gerçek fiyat ve doğrulama; rezervasyonlar test ortamında kalır (TEST- numaralı), hiç gerçekleştirilmez ve ücretlendirilmez. |
pxt_live_ | Canlı | Gerçek rezervasyon; operasyon ekibimiz gerçekleştirir, anlaşmanıza göre faturalanır. |
Anahtarları Panelim → API anahtarları bölümünde kendiniz oluşturup iptal edersiniz. Anahtar oluşturulduğu anda bir kez gösterilir; biz yalnızca özetini saklarız, tekrar gösteremeyiz. En fazla 10 aktif anahtarınız olabilir — her sunucu ya da ortam için ayrı anahtar kullanın ki birini kesinti olmadan yenileyebilesiniz.
Önemli: API anahtarları sadece sunucularınızdan kullanılmalı. Anahtarı asla web sitesine, mobil uygulamaya ya da açık bir kod deposuna koymayın. Sızmış olabilecek anahtarı hemen iptal edip yenisini oluşturun.
Görebileceğiniz hatalar
| HTTP | error.code | Anlamı |
|---|---|---|
| 401 | unauthorized | Anahtar yok, hatalı ya da iptal edilmiş. |
| 403 | forbidden | Hesabınız aktif değil ya da canlı anahtar onaydan önce kullanıldı. |
| 403 | ip_not_allowed | İstek hesabınıza kayıtlı olmayan bir IP adresinden geldi. Mesaj ve error.details.ip gördüğümüz adresi gösterir. |
| 429 | rate_limited | IP adresinizden çok fazla hatalı giriş denemesi. Bir dakika bekleyin. |
IP izin listesi
İstekler, anahtar geçerli olsa da yalnız hesabınıza kayıtlı IP adreslerinden kabul edilir. Kayıtlı adres yoksa canlı anahtarlar hiç çalışmaz.
- Sunucu IP adreslerinizi (IPv4 ya da IPv6) veya IPv4 aralıklarınızı (en geniş
/16, örneğin203.0.113.10, 198.51.100.0/24) Sorular bölümünden gönderin. Biz ekleriz; Panelim → API anahtarları sayfasında görürsünüz. - Geliştirme sırasında test anahtarlarınızı her adrese açabiliriz; böylece kendi bilgisayarınızdan ve konsoldan çalışırsınız. Canlı anahtarlar her zaman kayıtlı adreslerle sınırlı kalır.
- Sunucularınız ya da giden IP adresleriniz değişmeden önce bize haber verin.
Bağlantı güvenliği
- API sadece HTTPS üzerinden çalışır. Düz HTTP yönlendirilir, kullanılmamalı.
- Tarayıcıdan gelen istekler desteklenmez (CORS yok). API'yi arka uç sisteminizden çağırın.
- Bildirim imza anahtarını da API anahtarı gibi saklayın.