Teknik dokümantasyon

Genel bakış

Connect API, İstanbul envanterimizin otomatikleştirilebilir kısmını sunan, HTTPS üzerinden JSON tabanlı bir arayüzdür: müsaitlik araması, net fiyat fiyatlandırması ve anında onaylı rezervasyon. Veri akışı tabanlı iş ortakları aynı ürün verisini yapılandırılmış bir XML envanter akışı olarak alır.

Kimlik doğrulama

İstekler, TLS üzerinden bir Authorization başlığında gönderilen iş ortağına özel bir API anahtarıyla doğrulanır. Anahtarlar, entegrasyon sırasında her ortam (sandbox ve production) için ayrı verilir.

# Authorization başlığı
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx
Accept: application/json

Müsaitlik

Satış yapmadan önce bir ürün ve tarih aralığı için canlı müsaitliği ve net fiyatları sorgulayın. Yanıt, fiyatlar ve kurallarla birlikte rezerve edilebilir seçenekleri döndürür.

GET /v1/availability?product=hagia-sophia-grand-bazaar&date=2026-06-14

200 OK
{
  "product": "hagia-sophia-grand-bazaar",
  "currency": "EUR",
  "available": true,
  "options": [
    { "time": "09:00", "net": 149.50, "confirmation": "instant" }
  ]
}

Rezervasyon

Müsait bir seçeneğe karşılık bir rezervasyon oluşturun. Başarılı bir yanıt, standart envanter için anında bir onay referansı ve voucher bilgileri döndürür.

POST /v1/bookings
{
  "product": "hagia-sophia-grand-bazaar",
  "date": "2026-06-14",
  "time": "09:00",
  "pax": { "adults": 2, "children": 1 },
  "lead": { "name": "...", "email": "..." }
}

201 Created
{ "reference": "MKN-8F3A21", "status": "confirmed" }

Envanter akışları

Katalog senkronizasyonunu tercih eden iş ortakları; planlı veya talep üzerine çekilen, ürünler, açıklamalar, fiyatlar ve kurallardan oluşan bir XML akışı alır. Akış, çoğu acente ve OTA kataloğuna temiz biçimde eşlenir.

GET /feed/inventory.xml

<product code="hagia-sophia-grand-bazaar" type="tour">
  <title>Hagia Sophia & Grand Bazaar Tour</title>
  <duration>PT8H</duration>
  <net currency="EUR">149.50</net>
  <pickup>hotel</pickup>
</product>