TravelShop Booking API

Başlarken

API, HTTPS üzerinden JSON dönen düz bir REST API’dir; erişiminiz onaylandıktan sonra kendiniz ürettiğiniz tek bir API key ile doğrulanır. Aşağıdaki örneklerde {BASE_URL} yer tutucu olarak kullanılıyor — kendi base URL’iniz geliştirici panelinde, key’inizin yanında yazar.

1. 1

   Başvurun

   Platformunuzu anlatın. Her başvuruyu elle inceliyoruz, genellikle 1–2 iş günü içinde.

2. 2

   Key’inizi üretin

   Onaydan sonra geliştirici panelinden API key’inizi oluşturun ve API’yi çağıracak sunucuların IP adreslerini kaydedin. Key yalnızca bir kez gösterilir.

3. 3

   API’yi çağırın

   Key’i her istekte X-API-Key header’ı olarak gönderin. Tüm el sıkışma bundan ibaret.

Kimlik doğrulama

Key’inizi her istekte X-API-Key header’ında gönderin. OAuth akışı, token değişimi ve son kullanma tarihi yok — key’i yenileyene ya da iptal edene kadar geçerli kalır.

curl -X GET '{BASE_URL}/b2b/api/apiv2/b2c/tours/search?term=cappadocia&page_size=5' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Accept: application/json'

const res = await fetch(
  '{BASE_URL}/b2b/api/apiv2/b2c/tours/search',
  {
    method: 'POST',
    headers: {
      'X-API-Key': process.env.TSB_API_KEY,
      'Content-Type': 'application/json',
      Accept: 'application/json',
    },
    body: JSON.stringify({ term: 'cappadocia', page_size: 5 }),
  },
)

const data = await res.json()

IP izin listesi

Partner endpoint’leri yalnızca kaydettiğiniz sunucu IP adreslerinden gelen istekleri kabul eder. Erişiminiz onaylandıktan sonra sunucularınızın giden istekler için kullandığı genel (public) IP adreslerini geliştirici panelinden ekleyin — varsayılan olarak en fazla 3 adres.

• Tek tek IPv4 veya IPv6 adresleri kaydedin. Adres aralıkları, özel (private) ya da ayrılmış (reserved) adresler ve Cloudflare’e ait adresler kabul edilmez.
• Sitenizin IP’sini değil, sunucunuzun istek gönderdiği adresi kullanın. Siteniz Cloudflare arkasındaysa o adres Cloudflare’e aittir ve kaydedilemez.
• Sunucunuzda IPv6 varsa istekler IPv6 üzerinden çıkabilir. O adresi de kaydedin ya da HTTP istemcinizi IPv4 kullanmaya zorlayın. İki adresi de görmek için aşağıdaki komutları doğrudan sunucuda çalıştırın.
• Değişiklikler yaklaşık bir dakika içinde geçerli olur.

curl -4 https://api.ipify.org
curl -6 https://api64.ipify.org

Bir istek engellendiğinde

{
  "message": "This API key is not allowed from your IP address. Register it under Allowed server IPs in your developer dashboard.",
  "code": "ip_not_allowed",
  "ip": "203.0.113.10"
}

Rate limit ve kotalar

Birbirinden bağımsız iki limit var; ikisi de partner başına sayılır, kimseyle paylaşılmaz.

İki limitten birini aşmak 429 döndürür. Endpoint kırılımıyla güncel kullanımınızı geliştirici panelinizden görebilirsiniz.

İçerik kuralları

Tur arama ve içerik

Katalogda arama yapın ve turun tüm içeriğini çekin. Entegrasyonların çoğu bu endpoint’lerle başlar.

Katalog senkronizasyonu

Sayfalanmış iki değişiklik akışıyla herkese açık tur içeriğini ve güncel perakende hareket takvimlerini içe aktarın.

curl -G '{BASE_URL}/b2b/api/products/modified-since' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'count=100'

curl -G '{BASE_URL}/b2b/api/products/modified-since' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'cursor=NEXT_CURSOR'

{
  "products": [
    {
      "tourId": 123,
      "slug": "example-tour",
      "modifiedAt": "2026-10-20T08:00:00+00:00",
      "status": "ACTIVE",
      "product": {
        "id": 123,
        "slug": "example-tour",
        "name": "Example tour",
        "itineraries": []
      }
    }
  ],
  "nextCursor": null,
  "syncStartedAt": "2026-10-20T09:00:00+00:00"
}

{
  "products": [
    {
      "tourId": 123,
      "slug": "example-tour",
      "modifiedAt": "2026-10-20T08:15:00+00:00",
      "status": "INACTIVE"
    }
  ],
  "nextCursor": null,
  "syncStartedAt": "2026-10-20T09:00:00+00:00"
}

curl -G '{BASE_URL}/b2b/api/availability/schedules/modified-since' -H 'X-API-Key: YOUR_API_KEY' --data-urlencode 'modified-since=2026-10-20T09:00:00Z'

{
  "availabilitySchedules": [
    {
      "tourId": 123,
      "slug": "example-tour",
      "modifiedAt": "2026-10-20T08:00:00+00:00",
      "rates": [
        {
          "rateId": 456,
          "startsAt": "2026-11-01",
          "endsAt": "2026-11-30",
          "minPax": 1,
          "maxPax": 20,
          "currency": "EUR",
          "departureTypeId": "scheduled",
          "description": {
            "en": "Standard departure"
          },
          "prices": {
            "regular": {
              "dbl": 200
            }
          },
          "dates": [
            "2026-11-05"
          ]
        }
      ]
    }
  ],
  "nextCursor": null,
  "syncStartedAt": "2026-10-20T09:00:00+00:00"
}

Fiyat ve müsaitlik

Canlı hareket müsaitliği ve B2C perakende fiyatları. Partner API anahtarları tedarikçi net fiyatlarına erişim sağlamaz.

Destinasyonlar ve sınıflandırma

Filtrelerin, menülerin ve arama kutularının arkasındaki referans veri.

Talepler ve rezervasyonlar

Kendi platformunuzdan bizim tarafta talep oluşturun. Burada oluşturduğunuz her kayıt partner hesabınıza atfedilir ve panelinizde görünür.

Kullanımdan kaldırılan yanıt alanları

3 Kasım 2026’dan itibaren tur arama, tur detayı ve ürün akışı aşağıdaki alanları null olarak döndürür. Mevcut entegrasyonlar bozulmasın diye anahtarlar 1 Mayıs 2027’ye kadar yanıtta kalır; bu tarihten sonra kaldırılır. Bu alanlara dayanan geliştirme yapmayın.

Hatalar

Hatalar standart HTTP durum kodlarını kullanır; gövdede bir message ve — doğrulama hatalarında — alan adlarıyla anahtarlanmış bir errors nesnesi döner.

{
  "message": "The given data was invalid.",
  "errors": {
    "tour_id": ["The selected tour id is invalid."],
    "customers.0.email": ["The customers.0.email must be a valid email address."]
  }
}

Sürümleme