irdaweb Bilgi Teknolojileri
Telefon numaramız +90 541 209 02 05
E-posta adresimiz [email protected]
00 — Platform

skyhub. Bütün havayolları, tek API.

skyhub, sahip olduğunuz IATA acentelik kimlik bilgilerini güvenle saklar ve havayollarının kendi sistemlerine sizin adınıza bağlanır. Her uçuş arama, fiyat doğrulama, rezervasyon, biletleme ve iptal akışı tek bir normalize edilmiş API üzerinden yürür.

  • Komisyon paylaşımı yok
  • PCI-DSS uyumlu
  • Sandbox = canlı kapsam
  • Idempotent uçlar
api.skyhub · v1 live
POST /v1/flights/search
{
  "from": "IST",
  "to":   "AMS",
  "date": "2026-06-12",
  "pax":  { "adt": 1 }
}
200 OK 412 ms · 28 sonuç
  • TK TK1953 · 14:25 → 17:10 € 312
  • PC PC1259 · 15:40 → 18:35 € 268
  • XQ XQ7621 · 18:05 → 21:00 € 241
Uyum & sertifikasyon IATA acentelik bağlantısı PCI-DSS KVKK · GDPR SOC 2 yol haritasında
Bağlı taşıyıcılar

Aşağıdaki kodlar yalnızca örnek; aktif kapsam onboarding sırasında acentelik durumuna göre paylaşılır.

24 / 24 bağlantı
01 — Akış

Üç adımda canlıdasınız.

Sahip olduğunuz acentelik anlaşmalarını teknik bir altyapıya çevirmek için ekstra entegrasyon yazmanız gerekmez; akışın bütünü standart hale getirilmiştir.

  1. 01 Bağla

    Acentelik kimlik bilgilerini bağlayın

    Her havayolunun verdiği IATA/BSP kimlik bilgilerini güvenli panel üzerinden yüklersiniz. skyhub bunları şifreli bir kasada saklar; ham veriye uygulamamız bile erişmez.

  2. 02 Çağır

    Tek API'den çağrı yap

    Hangi havayolu olursa olsun aynı şema, aynı hata kodları, aynı doğrulama mantığı. Her havayolu için ayrı SDK öğrenmek gerekmez.

  3. 03 Sun

    Müşterilerinize kendi markanızla sunun

    Marjınız sizde, müşteri ilişkisi sizde. skyhub aradaki teknik gürültüyü kaldırır; siz yalnızca ürün deneyimine odaklanırsınız.

02 — Operasyonlar

Bir uçuş satışının tüm adımları.

Aramadan iptale kadar her aşama altı net uç noktadan yürüyor. Hiçbiri opak değil; her çağrının girdisi, çıktısı ve hata davranışı dokümante.

01 Search & Availability

Uçuş arama

Tarih, rota, yolcu sayısı ve sınıfa göre tüm uçuşları paralelde tarar; sonuçları normalize eder, fiyat ve müsaitlikle birlikte tek listede sunar.

POST /v1/flights/search
200 OK 412 ms
{
  "count": 28,
  "flights": [{ "carrier":"TK", "price":312 }, …]
}
02 Price Detail

Fiyat doğrulama

Rezervasyon öncesi havayolundan o anki kesin fiyatı, vergileri ve geçerlilik süresini döndürür. Fiyat farkı sizin için sürpriz olmaz.

POST /v1/flights/price
200 OK 287 ms
{
  "price": 312.40,
  "valid_until": "2026-06-08T14:25Z"
}
03 Reservation

Rezervasyon oluştur

Yolcu bilgileri ve seçili uçuşla bir PNR oluşturur. Havayolunun opsiyon süresini döndürür; ödeme bu süre içinde alınmalı.

POST /v1/reservations
201 CREATED 523 ms
{
  "pnr": "X4F2K9",
  "option_until": "2026-06-09T18:00Z"
}
04 CreateTicket

Bilet bas

Ödeme tahsil edildikten sonra TKT numarası oluşturur. Idempotent çağrı; aynı anahtarla yeniden denemek tek bir bilet üretir.

POST /v1/tickets
201 CREATED 892 ms
{
  "ticket": "235-1234567890",
  "status": "issued"
}
05 Cancel Preview

İptal önizlemesi

İade edilebilir tutarı, havayolu cezasını ve son tarihleri kesinleştirmeden döndürür. Müşterinize onaylatmadan kararı kesinleştirmeniz gerekmez.

GET /v1/tickets/:id/cancel/preview
200 OK 198 ms
{
  "refund": 248.10,
  "penalty": 64.30
}
06 Cancel Commit

İptali onayla

İptali kesinleştirir, koltuğu havayoluna iade eder ve iade tutarını başlatır. Tüm aşamalar denetim kaydına yazılır.

POST /v1/tickets/:id/cancel
200 OK 641 ms
{
  "status": "cancelled",
  "refund_id": "R-89A2C1"
}
03 — Avantajlar

Anlaşmalarınız sizde, altyapı bizimle.

Müşteri ilişkiniz ve marjınız sizde kalır; biz API tarafında durup teknik gürültüyü kaldırırız. Komisyon paylaşılmaz, içeriğinize karışılmaz — ürününüzü siz kurar, ölçeği birlikte taşırız.

Kendi anlaşmaların
Havayollarıyla yapmış olduğunuz komisyon, indirim ve tarife anlaşmaları doğrudan size yansır. skyhub bu ilişkiye girmez.
Tek normalize şema
Her havayolu farklı veri formatı, farklı zaman dilimi, farklı hata kodu döner. skyhub hepsini tek bir tutarlı yapıya çevirir.
Sandbox = canlı
Sandbox ortamı canlı ile aynı uçları, aynı hata davranışını ve aynı şemayı sunar. Sürpriz olmaz.
Hata toleransı
Idempotency key, retry-safe biletleme, opsiyon süresi takibi ve denetim logu varsayılan; iki kez bilet basma riski yok.
04 — Panel

Tüm operasyon, tek panelde.

Hacim, gelir, taşıyıcı kırılımı ve dönüşüm hunisi — tüm kritik göstergeleri tek bir raporlama panelinden takip edersiniz. Veriler API çağrılarınızdan gerçek zamanlı türetilir; ayrı bir entegrasyon kurmanız gerekmez.

Raporlama
son 7 gün canlı
Toplam rezervasyon
12.847
+18% · h/h
Brüt gelir
₺4,19 M
+12% · h/h
Ortalama bilet
₺326
−1.3% · h/h
Bilet başarı oranı
99,94 %
stabil
Günlük rezervasyon son 7 gün
Pzt
Sal
Çar
Per
Cum
Cmt
Paz
biletlenmiş rezervasyon
Taşıyıcı kırılımı hacme göre
  • TK Türk Hava Yolları 38%
  • PC Pegasus 24%
  • XQ SunExpress 14%
  • LH Lufthansa 9%
  • KL KLM 6%
Dönüşüm hunisi arama → bilet
Search 100%
184.293
Price Detail 26%
47.612
Reservation 12%
21.485
CreateTicket 7%
12.847
Cancel 0,8%
1.428
05 — Mimari

Üretim için tasarlandı.

Bir search çağrısı altı katmandan geçer ve çoğu zaman havayolunun yanıtını bekler. skyhub kendi ekleyeceği yükü minimumda tutar; geri kalanını denetim altına alır.

trace_id a4f8c2b1·19fe
POST /v1/flights/search
200 OK · 412 ms
  1. +0 ms

    Gateway

    skyhub

    İstek TLS üzerinden geliyor; API anahtarı doğrulanıyor, şema kontrol ediliyor, idempotency anahtarı tablo'dan eşleştiriliyor.

    Idempotency Rate limit Şema doğrulama
  2. +12 ms

    Vault

    skyhub

    Hedef havayolu için müşterinin acentelik kimliği KMS ile çözülüyor. Ham veri uygulama belleğine düşmüyor.

    Envelope encryption KMS
  3. +22 ms

    Carrier adapter

    skyhub

    İstek üç farklı taşıyıcının kendi şemasına çevriliyor; persistent connection üzerinden paralel olarak gönderiliyor.

    Normalize Retry-safe Persistent connection
  4. +24 ms

    Havayolu API'leri

    harici

    TK · PC · XQ kendi sistemlerine paralel sorgu. En yavaş halka burası; skyhub yalnızca timeout ve retry yönetir.

    ~358 ms
    toplam yanıt süresinin %87'si
  5. +402 ms

    Aggregate & Audit

    skyhub

    Üç yanıt tek şemaya çevriliyor, mükerrer sonuçlar ayıklanıyor, sıralama uygulanıyor; tüm istek-yanıt çiftleri değişmez denetim logu'na yazılıyor.

    Dedupe Sort Append-only log
  6. +412 ms

    Yanıt

    200 ok

    28 normalize edilmiş sonuç müşteri uygulamasına dönüyor. trace_id ile her adım sonradan izlenebilir kalır.

skyhub overhead
54 ms (13%)
harici (havayolu)
358 ms
paralel taşıyıcı
3 / 3 ✓
denetim logu
7 / 7 ✓
Search · p95
412 ms
↓ 18% · 30 gün
Bilet başarı oranı
99.94 %
stabil · 90 gün
Saatlik çağrı
2.5 M
↑ büyüyen kapasite
Bölgeler
3 / aktif
tr eu us
06 — Entegrasyon

Sandbox'tan canlıya, eşit kapsamla.

Geliştirme ekibinin ilk çağrısından canlı bilet basana kadar her adımı standartlaştırdık. Süreç tahmin edilebilir, dokümante.

  1. 01 Erişim

    Sandbox kimlik

    Saatler içinde sandbox erişim bilgisi; gerçek havayolu credential'ı gerekmeden testleri başlatabilirsiniz.

    ~2 saat
  2. 02 Kimlik

    Acentelik bağlama

    Her havayolu için sahip olduğunuz IATA/BSP kimliklerini panele yüklersiniz; doğrulama ve sağlık kontrolü skyhub'tan.

    ~1 gün
  3. 03 Sertifikasyon

    Havayolu testleri

    Bazı taşıyıcılar canlı öncesi sertifikasyon ister. Senaryoları birlikte yürütüyor, çıktıları paylaşıyoruz.

    taşıyıcıya bağlı
  4. 04 Canlı

    Tek satır geçiş

    Aynı API URL'i, prod credential'larıyla. Kod değişmez; ortam bayrağı değişir, canlıdasınız.

    anında
07 — Hedef kitle

Sahip olduğunuz anlaşmaları teknik güce çevirir.

Acentelik anlaşmaları olan ama her havayolu için ayrı entegrasyon yazmaktan kaçınan ekipler için tasarlandı.

  • OTA
    Online seyahat platformları

    Çok taşıyıcılı arama, hızlı checkout, tek noktadan iptal yönetimi.

  • Kurumsal
    Şirket seyahat araçları

    Politika kontrolü, onay akışları ve maliyet merkezi raporlamayla bütünleşir.

  • Tur operatörü
    Paket seyahat ekipleri

    Otel, transfer ve uçuş paketlerinde uçuş tarafını standartlaştırır.

  • Süper uygulama
    Fintech & lifestyle

    Mobil uygulama içinde uçuş alma deneyimini hızlıca devreye alın.

08 — SSS

Karar vermeden önce netleşelim.

Aradığın cevabı bulamadıysan bize ulaş.

Havayolu acentelik anlaşmamız yoksa skyhub'ı kullanabilir miyiz?

Hayır. skyhub kendi adına havayolu içeriği satmaz; sahip olduğunuz IATA/BSP acentelik kimlik bilgileriyle havayolunun kendi sistemine bağlanır.

Anlaşma süreciniz yoksa BSP başvurusu, taşıyıcıya doğrudan başvuru veya bir ana acente ile çalışma seçenekleri konusunda yönlendirme sağlayabiliriz; ancak anlaşmanın imzası tarafınızca tamamlanır.

Komisyon ya da gelir paylaşımı talep ediyor musunuz?

Hayır. skyhub teknik bir entegrasyon katmanı; uçuş satışlarından komisyon almıyor. Aylık API kullanım planı ve sözleşmeniz dışında ek bir maliyet yok.

Marjlar acentelik anlaşmalarınızla doğrudan size kalır.

Hangi havayollarına bağlanabilir?

Türkiye merkezli ve uluslararası taşıyıcıların doğrudan acentelik API'leriyle entegrasyon kuruyoruz. Aktif kapsam onboarding sırasında paylaşılır.

Listede olmayan bir taşıyıcı için talep alıyor ve entegrasyon yol haritamıza ekliyoruz.

Sandbox ortamı canlı kapsamla aynı mı?

Evet. Sandbox; canlı ile birebir aynı uç noktalarını, hata kodlarını ve veri şemasını sunar. Yalnızca arka planda gerçek kontenjan yerine simülasyon kullanılır.

Aynı integration kodu prod credentials ile değiştirilince canlıya geçer; iki ortam arasında "neden farklı çalışıyor" tartışması olmaz.

Fiyat garantisi nasıl çalışır?

Search çıktısı bilgilendirme amaçlıdır; Price Detail çağrısı havayolundan o anki kesin fiyatı ve geçerlilik süresini döndürür. Reservation aynı oturumda yapılırsa fiyat sabitlenir.

Ödeme gecikmelerine karşı havayolunun belirttiği opsiyon süresine uyulmalıdır; süre aşıldığında havayolu fiyatı yeniden çağırmanı isteyebilir.

İptal politikası kimin sorumluluğunda?

İptal kuralları ve iade tutarları havayolu tarifesine bağlıdır. Cancel Preview çağrısı net iade tutarını ve cezayı önceden döndürür; Cancel Commit ile işlem kesinleşir.

skyhub bu akışı standartlaştırır; ücret/iade hesaplaması her zaman havayolunun politikasına aittir.

İletişim

Sandbox erişimini birlikte açalım.

Acentelik anlaşmalarınızı paylaşın; uygun kapsam ve teknik gereksinim listesiyle dönüş yapalım. Sandbox erişimi ücretsizdir, sözleşmeden önce her şeyi deneyebilirsiniz.