Kimler için
API anahtarı bir Tourwix B2B iş ortağı firmasına aittir. Bu firmanın kendi yazılımı ya da onun için çalışan teknik ekip kullanır.
Online acenteler (OTA)
Uçuş ya da otel rezervasyonunun yanına havalimanı transferini kendi sepetinizde ekleyin.
Tur operatörleri
Paket turlarınızın transferlerini kendi rezervasyon sisteminizden tek tek ya da toplu açın.
Oteller ve kurumsal firmalar
Misafir ve çalışan transferlerini kendi iç sisteminizden ayırtın.
Teknoloji ortakları
Bir iş ortağı firmasının rezervasyon motoruna Tourwix bağlantısını siz kurun; anahtar o firmanın portalında oluşur.
API ile neler yapabilirsiniz
Aşağıdakilerin hepsi bugün çalışan uç noktalardır. Rezervasyon kuralları partner portalındakiyle aynıdır.
Fiyat alın
Transfer, saatlik araç ve gezi transferi için araç seçenekli teklif. Teklif 15 dakika geçerlidir.
Rezervasyon açın
Teklifteki bir seçeneği rezerve edin. Idempotency-Key ile ağ hatasında tekrar deneme çift rezervasyon açmaz.
Durumu izleyin
API ile açtığınız rezervasyonları listeleyin; tek rezervasyonu ayakları ve talep durumuyla okuyun. Kendi rezervasyon numaranızla da arayabilirsiniz.
İptal ve değişiklik talebi
İptal ve değişiklikler talep olarak gelir; Tourwix operasyonu onaylar ya da reddeder.
Adres ve gezi noktaları
Havalimanı, otel ve adres araması; aktif gezi noktalarının listesi.
Nasıl başlanır
Canlıya geçene kadar hiçbir gerçek rezervasyon açılmaz ve carinizden tutar düşmez.
- 1
B2B iş ortağı olun
Acente, otel, kurumsal ya da operatör olarak başvurun. Başvuru Tourwix tarafından onaylanır.
- 2
Portalda API erişimine başvurun
Partner portalında API erişimi ekranından kısa bir kullanım amacı yazın. Test (sandbox) erişimi hemen açılır.
- 3
Test anahtarı oluşturun ve deneyin
tw_test_ ile başlayan anahtarla fiyat alın ve deneme rezervasyonu açın. İstek kaydını portalda izleyin.
- 4
Canlıya geçin
API sözleşmesi ve cari limiti tanımlandıktan sonra Tourwix canlı erişimi açar; tw_live_ anahtarınızı oluşturursunuz.
Test (sandbox) — tw_test_…
- Başvuru sonrası hemen açılır
- Gerçek transfer oluşturmaz
- Carinizden tutar düşmez
- Canlıyla aynı uç noktalar ve yanıtlar
Canlı — tw_live_…
- Tourwix onayıyla açılır (sözleşme + cari limiti)
- Gerçek rezervasyon açar, operasyon hemen görür
- Tutar şirket carinize yazılır
- Sınırlar firmanıza göre ayarlanır
Fiyat ve ödeme
Portal net fiyatı
API fiyatı, firmanızın partner portalında gördüğü net fiyatla aynıdır (firma ekleri dahil, kişisel ek yok). API için ayrı bir ek ücret yoktur.
Yalnız cari ödeme
Rezervasyonlar şirket carinize yazılır (payment: account). Cari limit yetmezse 402 insufficient_credit döner.
Tutarlar EUR
net_total carinize yazılan tutar, guest_total misafir fiyatıdır. Rezervasyonda fiyat yeniden hesaplanır; değiştiyse 409 price_changed ve yeni teklif döner.
İstek sınırları
Sınırlar anahtar başına uygulanır. Varsayılanlar aşağıda; Tourwix firmanız için değiştirebilir.
- istek / dakika
- 60
- adres araması / dakika
- 20
- rezervasyon / gün
- 50
Sınır aşılırsa 429 ve Retry-After başlığı döner. Günlük rezervasyon sınırını artırmak için Tourwix ile görüşün.
Kimlik doğrulama ve güvenlik
Bearer anahtar
Her istekte Authorization: Bearer <anahtar>. Temel adres https://api.tourwix.com/v1.
Yetki kapsamları
quotes:read, bookings:write, bookings:read, requests:write. Anahtara yalnız gereken yetkiyi verin.
Bir kez gösterilir
Anahtarın gizli kısmı oluşturulurken bir kez gösterilir; Tourwix yalnız özetini (hash) saklar.
Döndürme ve iptal
Anahtarı döndürdüğünüzde eskisi en çok 7 gün daha çalışır; iptal ettiğinizde hemen durur.
İzlenebilir yanıtlar
Her yanıtta X-Request-Id vardır. Hatalar code ve request_id alanlı problem+json gövdesiyle döner.
Kişisel veri sınırı
Şoför telefonu ve tedarikçi bilgisi API ile hiç gönderilmez.
Hızlı başlangıç
Üç istekte fiyat alın, rezervasyon açın ve okuyun. Örneklerde test anahtarı kullanılır.
curl -X POST https://api.tourwix.com/v1/quotes \
-H "Authorization: Bearer tw_test_xxxxxxxxxxxx_..." \
-H "Content-Type: application/json" \
-d '{"product":"transfer","pickup":{"id":"<id from /v1/locations>"},
"dropoff":{"label":"Hotel","lat":36.85,"lng":30.85},
"pickup_date":"2026-11-02","pickup_time":"14:30",
"passengers":{"adults":2},"luggage":2}'curl -X POST https://api.tourwix.com/v1/bookings \
-H "Authorization: Bearer tw_test_xxxxxxxxxxxx_..." \
-H "Idempotency-Key: 8d0f6c1e-booking-001" \
-H "Content-Type: application/json" \
-d '{"quote_id":"q_...","offer_id":"of_1","payment":"account",
"partner_reference":"PNR-12345",
"lead_passenger":{"name":"Jane Doe","phone":"+44 7700 900000"},
"flight_number":"TK1234","language":"en"}'curl https://api.tourwix.com/v1/bookings/<id or reference> \
-H "Authorization: Bearer tw_test_xxxxxxxxxxxx_..."Uç noktalar
| Uç nokta | Yetki | Ne yapar |
|---|---|---|
| POST/v1/quotes | quotes:read | Transfer, saatlik araç ya da gezi transferi için teklif. 15 dakika geçerli. |
| GET/v1/quotes/{id} | quotes:read | Bir teklifi okur. |
| POST/v1/bookings | bookings:write | Tekliften rezervasyon açar. Idempotency-Key başlığı zorunlu. Ödeme: cari. |
| GET/v1/bookings | bookings:read | API ile açtığınız rezervasyonlar (imleçli sayfalama). |
| GET/v1/bookings/{id|reference} | bookings:read | Rezervasyon, ayaklar ve talep durumu. |
| POST/v1/bookings/{id}/cancellation-requests | requests:write | İptal talebi; Tourwix onaylar. |
| POST/v1/bookings/{id}/amendment-requests | requests:write | Değişiklik talebi; Tourwix onaylar. |
| GET/v1/excursion-destinations | quotes:read | Aktif gezi noktaları. |
| GET/v1/locations?q= | quotes:read | Adres araması (daha sıkı sınır). |
| GET/v1/openapi.json | — | OpenAPI 3.1 belgesi (anahtar gerekmez). |
Sürüm 1.1.0 (2026-10-18): teklif yanıtında geriye uyumlu warnings alanı. lead_time_too_short (min_lead_minutes): alış en kısa rezervasyon sürenizden yakın; canlı rezervasyon açılmaz.
Hata kodları
- 401 unauthorizedAnahtar yok, hatalı, iptal edilmiş ya da süresi dolmuş.
- 403 insufficient_scope / partner_not_activeAnahtarda bu yetki yok ya da bu ortam için erişiminiz açık değil.
- 404 not_foundBulunamadı — başka bir firmanın teklifi ya da rezervasyonu için de bu döner.
- 402 insufficient_creditŞirket cari limiti yetmiyor.
- 409 quote_expired / quote_usedYeni teklif alın.
- 409 price_changedFiyat yeniden hesaplamada değişti; body.new_quote içinde yeni teklif var.
- 409 idempotency_in_progressAynı Idempotency-Key hâlâ işleniyor — kısa süre sonra tekrar deneyin.
- 422 idempotency_key_reusedAynı Idempotency-Key farklı gövdeyle gönderildi.
- 422 booking_unavailableİş kuralı (ör. en az önceden rezervasyon süresi). reason_tr alanına bakın.
- 429 rate_limited / daily_booking_capYavaşlayın (Retry-After) ya da günlük sınırı artırmak için Tourwix ile görüşün.
Sık sorulan sorular
Test anahtarı için sözleşme gerekiyor mu?
Hayır. Onaylı B2B iş ortağıysanız portaldan başvurduğunuzda test erişimi hemen açılır. Sözleşme ve cari limiti yalnız canlı erişim için gerekir.
API fiyatı portaldaki fiyattan farklı mı?
Hayır. API, firmanızın portalda gördüğü net fiyatı kullanır. Misafire satış fiyatınızı kendi sisteminizde belirlersiniz.
Kartla ödeme alabilir miyim?
API'de ödeme yalnız şirket carisinden yapılır. Misafirden kartla tahsilat isterseniz partner portalındaki misafir ödeme linkini kullanabilirsiniz.
Rezervasyonu API ile iptal edebilir miyim?
İptal ve değişiklikler talep olarak gönderilir; Tourwix operasyonu onaylar ya da reddeder. Durumu rezervasyonu okuyarak izlersiniz.
Webhook var mı?
Şu an yok. Rezervasyon ve talep durumunu GET /v1/bookings/{id} ile okuyun.
Boş dönüş ilanları API'de satılıyor mu?
Hayır. API transfer, saatlik araç ve gezi transferi satar; boş dönüş ilanları yalnız portalda.
Anahtarı kim yönetebilir?
Firmanızda cari ile rezervasyon yetkisi olan kullanıcılar. Anahtarla açılan rezervasyonlar firma sahibinin adına kaydedilir.
Kod yazmadan satmak isterseniz
Entegrasyona bugün başlayın
İş ortağıysanız giriş yapıp test anahtarınızı oluşturun. Değilseniz önce B2B başvurusu yapın.