Kimlik doğrulama ve anahtarlar

Anahtar türleri, yetkiler, IP kısıtı ve güvenlik.

Her istek Authorization: Bearer <anahtar> başlığı taşır.

http

GET /v1/me HTTP/1.1
Host: api.example.com
Authorization: Bearer bp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Ortamlar

Önek	Ortam	Ne görür
`bp_test_…`	Sandbox	Yalnızca sizin örnek mülkleriniz. Gerçek veriye dokunamaz.
`bp_live_…`	Canlı	Ağdaki gerçek mülkler. Yalnızca onaylı acenteler alabilir.

Bir anahtar yalnızca kendi ortamındaki mülklere erişir: test anahtarıyla canlı bir mülk istediğinizde 404 property_not_found alırsınız, tersi de öyle.

Yetkiler (scope)

Yetki	İzin verir
`catalog:read`	Olanak, tür, yer ve para birimi kataloğu
`properties:read`	Mülkleri, fotoğrafları, abonelikleri okumak; indirmek
`subscriptions:write`	Abone olmak ve aboneliği bırakmak
`calendar:read`	Takvimi ve iCal'i okumak
`rates:read`	Fiyatları, müsaitliği ve teklifi okumak
`reservations:read`	Opsiyon ve rezervasyonları okumak
`reservations:write`	Opsiyon, rezervasyon, değişiklik, iptal
`events:read`	Olay günlüğünü okumak
`webhooks:manage`	Webhook adreslerini ve teslimatları yönetmek

Yetkisi olmayan çağrı 403 scope_missing döner; eksik yetkinin adı detail alanındadır. Raporlama yazılımı gibi yalnızca okuyan sistemler için salt okunur anahtar oluşturun.

IP kısıtı

Bir anahtara izinli IP adresleri veya CIDR aralıkları (örn. 203.0.113.0/24, 2001:db8::/32) tanımlayın. Dışarıdan gelen çağrı 403 ip_not_allowed alır. Sunucunuz sabit adresten çıkıyorsa mutlaka kullanın.

Güvenlik

Anahtarı yalnızca sunucunuzda tutun; tarayıcıya, mobil uygulamaya veya depoya koymayın.
Biz anahtarın kendisini saklamayız, yalnızca özetini. Kaybederseniz yenisini oluşturun.
Sızdığından şüphelenirseniz Geliştirici sayfasından anahtarı iptal edin; etkisi anında olur.