Canlı demo

Rehber

API entegrasyonu nedir, seyahat işletmeleri için anlatıldı

API entegrasyonu, iki yazılım sisteminin kimse yeniden veri girmeden bilgi alışverişi yapmasını ve işlemleri tetiklemesini sağlayan bir bağlantıdır. Bu rehber, yolcu, rezervasyon platformu, tedarikçi API'si ve ödeme ağ geçidi arasında dolaşan tek bir otel rezervasyonu üzerinden nasıl çalıştığını anlatır.

  • Bir istek, bir yanıt
  • REST, XML, SOAP ve webhook
  • Dört sistemde izlenen bir rezervasyon
  • Entegrasyonlar nasıl test edilir

Tanım

API entegrasyonu nedir, sade dille

API, uygulama programlama arayüzü demektir: bir sistemin, başka yazılımların kendisiyle konuşabilmesi için yayımladığı kurallar bütünü. API entegrasyonu ise platformunuzu bu arayüzlerden birine bağlayarak verinin kendiliğinden akmasını ve işlemlerin otomatik gerçekleşmesini sağlama işidir.

Seyahatte bu platform genellikle Seyahat rezervasyon yazılımı gibi bir rezervasyon sistemidir; arayüz ise bir tedarikçiye, ödeme ağ geçidine veya iş aracına aittir. Seyahat API entegrasyonu sayfamız PHPTRAVELS'ın bu bağlantıları nasıl teslim ettiğini anlatır, Tüm entegrasyonlar ise bağlı tedarikçileri listeler.

  • Veri alışverişi

    Fiyatlar, müsaitlik, müşteri bilgileri ve durum güncellemeleri sistemler arasında yapılandırılmış biçimde taşınır.

  • İşlemleri otomatikleştirme

    Arama, rezervasyon, ödeme, iptal ve mutabakat birinin elle tekrarladığı adımlar değil, istekler olarak gerçekleşir.

  • Sonuçları izleme

    Her çağrı bir referans taşır; başarısız bir rezervasyon ona yol açan isteğe kadar izlenebilir.

İstek

POST /v1/hotels/availability HTTP/1.1Host: api.supplier.exampleAuthorization: Bearer sk_test_••••••••Content-Type: application/json{  "city": "DXB",  "check_in": "2026-11-12",  "check_out": "2026-11-14",  "guests": 2,  "currency": "USD"}

Yanıt

HTTP/1.1 200 OKContent-Type: application/jsonX-Request-Id: req_7f3a91{  "hotel": "Palm Marina Hotel",  "room": "Deluxe, 2 adults",  "rate": { "amount": 438.00, "currency": "USD" },  "refundable": true,  "rate_key": "rk_19d2c7"}
Hayali bir otel tedarikçisine örnek çağrı. Alan adları, uç noktalar ve tutarlar tedarikçiden tedarikçiye değişir.

Bir API çağrısının anatomisi

  1. 1

    Uç nokta ve yöntem

    İşlemin adresi ve ona uygulanan fiil: availability'ye POST, oda ara demektir.

  2. 2

    Kimlik doğrulama

    Anahtar, token veya imza kimin çağırdığını kanıtlar. Tedarikçiler sandbox ve üretim için ayrı kimlik bilgileri verir.

  3. 3

    Yük (payload)

    Yapılandırılmış girdi: şehir, tarihler, misafirler ve para birimi. Her alanı tedarikçinin dokümantasyonu tanımlar.

  4. 4

    Durum kodu

    Çağrının nasıl geçtiğini söyleyen sayı: 200 başarı, 4xx istekte sorun, 5xx tedarikçi tarafında sorun.

  5. 5

    İstek kimliği

    Her iki tarafın sakladığı tanımlayıcı. Destek ekibi bir rezervasyona ne olduğunu sorduğunda aradığı şey budur.

  6. 6

    Yanıt gövdesi

    Tedarikçinin biçimindeki cevap; platformunuz bunu kendi odalarına, fiyatlarına ve politikalarına eşler.

Bir rezervasyon, dört sistem

Otel rezervasyonu sırasında API entegrasyonu ne yapar

İki gecelik bir konaklamayı aramadan vouchera kadar izleyin. Her ok bir API çağrısıdır; yolcu yalnızca ilkini ve sonuncusunu görür.

  1. 01YolcuRezervasyon platformuDubai'de otel arar, iki gece, iki misafir
  2. 02Rezervasyon platformuTedarikçi API'siTarih, misafir ve para birimiyle müsaitlik isteği
  3. 03Tedarikçi API'siRezervasyon platformuOdalar, fiyatlar, politikalar ve bir fiyat anahtarı
  4. 04Rezervasyon platformuYolcuSonuçlar kâr marjınız ve para biriminizle gösterilir
  5. 05Rezervasyon platformuTedarikçi API'siÖdemeden önce seçilen fiyat anahtarında fiyat yeniden kontrolü
  6. 06Rezervasyon platformuÖdeme ağ geçidiToplam tutar için ödeme yetkilendirmesi
  7. 07Ödeme ağ geçidiRezervasyon platformuYetkilendirildi, imzalı webhook alındı
  8. 08Rezervasyon platformuTedarikçi API'siMisafir bilgileriyle rezervasyon isteği
  9. 09Tedarikçi API'siRezervasyon platformuOnay numarası ve iptal koşulları
  10. 10Rezervasyon platformuYolcuVoucher, fatura ve rezervasyon referansı

Ortadaki platform, API entegrasyonunun yaşadığı yerdir: yolcunun ekranı ile her tedarikçinin biçimi arasında çeviri yapar ve her referansı saklar.

Aynı sıra GDS ile Uçak bileti rezervasyon yazılımı, aktivite tedarikçisiyle Tur operatörü yazılımı ve herhangi bir ağ geçidiyle Ödeme ağ geçidi entegrasyonu için de geçerlidir; yalnızca alan adları değişir.

Entegrasyon tarzları

REST, XML, SOAP, webhook ve GraphQL

Tedarikçiler arayüzlerini farklı tarzlarda yayımlar. Tarzı tercih değil tedarikçinin dokümantasyonu belirler; bu yüzden bir seyahat platformunun hepsini konuşması gerekir.

  • REST ve JSON

    JSON
    Veri biçimi
    JSON belgeleri
    Taşıma
    HTTP yöntemleri: GET, POST, PUT, DELETE
    Seyahatte yaygın
    Yeni uçuş, otel, aktivite ve ödeme API'leri
    Güçlü yanı
    Küçük yükler ve geniş geliştirici araçları
    Dikkat edin
    Gevşek tanımlı; her tedarikçi REST'i farklı yorumlar

  • XML ve SOAP

    XML
    Veri biçimi
    XML belgeleri, çoğu zaman katı şemalı
    Taşıma
    SOAP zarfı veya düz XML ile HTTP POST
    Seyahatte yaygın
    GDS, yatak bankaları ve köklü otel ve tur sistemleri
    Güçlü yanı
    Resmi sözleşmeler, imzalar ve servis tanımları
    Dikkat edin
    Uzun mesajlar ve daha ağır ayrıştırma

  • Webhook

    EVENT
    Veri biçimi
    Karşı tarafın gönderdiği JSON veya XML
    Taşıma
    Kaydettiğiniz URL'ye HTTP POST
    Seyahatte yaygın
    Ödeme sonuçları, rezervasyon durumu değişiklikleri, biletleme güncellemeleri
    Güçlü yanı
    Yoklama yok; bir şey olduğunda platformunuz haberdar edilir
    Dikkat edin
    İmzalar doğrulanmalı ve tekrarlar ele alınmalı

  • GraphQL

    QUERY
    Veri biçimi
    Gönderdiğiniz sorgunun biçimlendirdiği JSON
    Taşıma
    Tek bir HTTP uç noktası
    Seyahatte yaygın
    Bazı yeni dağıtım platformları ve iç API'ler
    Güçlü yanı
    Tam olarak ihtiyacınız olan alanları isteyin
    Dikkat edin
    Seyahat tedarikçilerinde destek hâlâ yaygın değil

API entegrasyonu ile API geliştirme

API entegrasyonu

Ürününüzü zaten var olan bir arayüze bağlar. API tedarikçinindir; siz istemciyi, eşlemeyi ve etrafındaki kuralları kurarsınız.

API geliştirme

Başka sistemlerin ürününüze bağlanmak için kullandığı bir arayüz oluşturur; örneğin acentelerinizin araçlarının çağırabileceği bir B2B API. Sözleşme ve sürümleri sizindir.

Birçok seyahat projesi ikisine de ihtiyaç duyar: platform bir yanda tedarikçileri entegre eder, öte yanda acenteler ve iş ortakları için kendi API'sini yayımlar.

Öncesi ve sonrası

Sistemler entegre olduğunda ne değişir

Bir rezervasyonun aynı beş adımı: tedarikçi portallarında elle yapılan ve API entegrasyonuyla yapılan.

Arama

Entegrasyon olmadanElle

Bir acente her tedarikçi portalını açar ve fiyatları teklife kopyalar.

API entegrasyonuylaOtomatik

Tek arama bağlı tüm tedarikçilere dağılır ve tek bir liste döner.

Fiyat

Entegrasyon olmadanElle

Kâr marjı tabloda eklenir; teklif gönderilene kadar fiyat değişmiş olabilir.

API entegrasyonuylaOtomatik

Kâr marjı, vergiler ve para birimi kuralları yanıt anında uygulanır; fiyat ödemeden önce yeniden kontrol edilir.

Rezervasyon

Entegrasyon olmadanElle

Misafir bilgileri tedarikçi portalına yeniden yazılır; yazım hataları rezervasyon hatasına dönüşür.

API entegrasyonuylaOtomatik

Bilgiler bir kez gönderilir, doğrulanır ve tedarikçinin onayıyla birlikte saklanır.

Ödeme

Entegrasyon olmadanElle

Ödeme ayrı tahsil edilir ve rezervasyonla sonradan eşleştirilir.

API entegrasyonuylaOtomatik

Yetkilendirme, tahsilat ve iade rezervasyon referansına bağlıdır.

Hizmet

Entegrasyon olmadanElle

İptaller ve değişiklikler bir giriş ve bir e-posta daha demektir.

API entegrasyonuylaOtomatik

Değişiklik ve iptaller aynı bağlantı üzerinden yürür ve kaydı günceller.

API entegrasyonu bir seyahat platformunda nerelerde görülür

Sözlük

API dokümantasyonunda karşılaşacağınız terimler

Hemen her tedarikçinin geliştirici portalında geçen on iki kelime, seyahatte kullanıldıkları haliyle tanımlandı.

  • API

    Uygulama programlama arayüzü: bir sistemle konuşmak için yayımlanmış kurallar.

  • Kimlik doğrulama

    API anahtarı, bearer token, imza veya onaylı IP adresiyle kimin çağırdığını kanıtlama.

  • Sertifikasyon

    Üretim kimlik bilgileri verilmeden önce tedarikçinin entegrasyonunuzu incelemesi.

  • Uç nokta

    Arama, rezervasyon veya iptal gibi tek bir işlem için tek bir adres.

  • İdempotans

    Aynı isteği iki kez göndermek tek sonuç üretir; bu da çift rezervasyon ve çift tahsilatı önler.

  • Eşleme

    Tedarikçinin alanlarını, kodlarını ve adlarını platformunuzun kendi veri modeline çevirme.

  • Yük (payload)

    Bir istek veya yanıtın içinde taşınan veri, genellikle JSON veya XML.

  • Hız sınırı

    Tedarikçinin reddetmeye başlamadan önce saniyede veya günde izin verdiği çağrı sayısı.

  • İstek ve yanıt

    Tek çağrı: platformunuz sorar, tedarikçi cevaplar ve iki taraf da kaydeder.

  • Sandbox

    Sahte envanter ve test kartlarıyla hiçbir şeyin gerçekten rezerve edilmediği veya tahsil edilmediği test ortamı.

  • Durum kodu

    Sonucu özetleyen HTTP sayısı: 200 başarı, 401 yetkisiz, 429 hız sınırı, 500 tedarikçi hatası.

  • Webhook

    Ters yönde bir çağrı: bir olay olduğunda tedarikçi veya ağ geçidi platformunuza haber verir.

Test ve kapsam

Bir seyahat API entegrasyonu yayına alınmadan önce nasıl test edilir

Bir entegrasyon ancak hatalı yollar da doğru davrandığında biter. Tedarikçi sandbox'ında yapılan bir test turu, sertifikasyondan ve üretim kimlik bilgilerine geçişten önce aşağıdaki durumları kapsar.

run integration tests

tedarikçi sandbox'ı, dokuz durum

  • OK: Geçerli ve süresi dolmuş kimlik bilgileriyle kimlik doğrulama
  • OK: Geçersiz istek okunabilir bir hatayla reddedildi
  • OK: Tedarikçi zaman aşımı askıda rezervasyon bırakmadan ele alındı
  • OK: Hız sınırına uyuldu ve bekleme sonrası yeniden denendi
  • OK: Fiyat değişikliği yeniden kontrolde yakalandı ve ödemeden önce gösterildi
  • OK: Mükerrer gönderim ikinci değil ilk rezervasyonu döndürür
  • OK: İptal uygulandı ve ücretler hesaplandı
  • OK: İade orijinal ödeme üzerinden yapıldı
  • OK: Rezervasyon, ödeme ve tedarikçi referansları mutabık

Tüm durumlar geçti, sertifikasyona hazır

Kapsam belirleme için sizden gerekenler

  1. 1Tedarikçi sözleşmesi, dokümantasyon ve sandbox kimlik bilgileri
  2. 2Pazarlar, para birimleri, ürünler ve kullanıcı rolleri
  3. 3Arama, rezervasyon, değişiklik, iptal ve iade kapsamı
  4. 4Sertifikasyon gereksinimleri ve üretim erişim süreci

Bir tedarikçi bağlamaya hazır

PHPTRAVELS tedarikçileri, ağ geçitlerini ve iş araçlarını kaynak koduyla teslim edilen kendi sunucunuzda barındırılan bir platforma entegre eder. Üç tek seferlik plan için Fiyatlandırma sayfasına bakın veya belirli bir API'yi bize sorun.

Demo isteyinBizimle konuşun

Okumaya devam edin

Sorular

API entegrasyonu soruları ve yanıtları

İlk entegrasyon projesinden önce sorulan sorulara kısa yanıtlar.

Satış ekibiyle görüşün

API entegrasyonu, iki yazılım sisteminin otomatik olarak veri alışverişi yapmasını ve işlemleri tetiklemesini sağlayan bağlantıdır. Bir sistem yapılandırılmış bir istek gönderir, diğeri yapılandırılmış bir yanıt döndürür ve ikisi de üzerinde anlaşılmış güvenlik ve veri kurallarına uyar.

Seyahatte bir rezervasyon platformunu uçuş, otel, tur veya araç tedarikçileri, ödeme ağ geçitleri ve iş araçlarıyla bağlar. Yeniden veri girmeden arama, fiyat doğrulama, rezervasyon, iptal, iade ve mutabakatı destekler.

REST, genellikle HTTP üzerinden JSON alışverişi yapan bir mimari tarzdır. XML ise GDS ve yatak bankası tedarikçilerinde hâlâ yaygın olan, çoğu zaman SOAP içine sarılmış bir veri biçimidir. Hangisini kullanacağınıza tedarikçinin sözleşmesi ve dokümantasyonu karar verir.

Tedarikçi erişimine, kapsamdaki uç noktalara, sertifikasyona, eşleme kurallarına ve rezervasyonun uç durumlarına bağlıdır. Güvenilir bir tahmin; dokümantasyon, kimlik bilgileri ve ihtiyaç duyduğunuz iş akışları incelendikten sonra verilir.

Kimlik doğrulamayı, geçerli ve geçersiz istekleri, zaman aşımlarını, hız sınırlarını, fiyat değişikliklerini, mükerrer gönderimleri, iptalleri, iadeleri ve mutabakatı test edin. Üretimde her istek bir rezervasyon referansına kadar izlenebilmelidir.

Hayır. Entegrasyon ürününüzü var olan bir API'ye bağlar; geliştirme ise başkalarının bağlandığı bir arayüz oluşturur. Seyahat platformları çoğu zaman ikisine de ihtiyaç duyar: bir yanda entegre tedarikçiler, öte yanda iş ortakları için yayımlanmış bir B2B API.

Keşfetmeye devam edin

Platform hakkında daha fazlası