Partner API Dokümanı · Grand Aras Yönetim

1 · Genel Bakış

Partner API, entegrasyon yeteneği olan acentelerin Grand Aras Hotel & Suites'in müsaitlik ve net fiyat bilgisini kendi sistemlerine çekmesini ve rezervasyon oluşturmasını sağlar.

Temel adres	`https://api.grandaras.com/v1`
Test adresi	`https://test.api.grandaras.com/v1`
İstek biçimi	`application/json`
Yanıt biçimi	`application/json` veya `application/xml` (Accept başlığı)
Zaman dilimi	Europe/Istanbul (UTC+3) · ISO 8601

2 · Kimlik Doğrulama

Her istekte size özel API anahtarı gönderilir. Anahtar acentenizin pazarını ve acente tipini belirler; yanıtlar buna göre filtrelenir.

GET /v1/availability HTTP/1.1
Host: api.grandaras.com
Authorization: Bearer gk_live_7f3a…c21
Accept: application/json

Yanıtlarda yalnızca kendi tipinizin fiyatları yer alır. Diğer tipin fiyatı hiçbir parametreyle çağrılamaz.

3 · Müsaitlik

GET /v1/availability

Parametre	Tip	Zorunlu	Açıklama
`checkin`	date	Evet	YYYY-MM-DD
`checkout`	date	Evet	YYYY-MM-DD
`adults`	int	Evet	Yetişkin sayısı
`children`	int[]	Hayır	Çocuk yaşları, örn. `[6,10]`. Fiyat otelin çocuk politikasıyla hesaplanır:
`rooms`	int	Hayır	Varsayılan 1
`roomType`	string	Hayır	Örn. `DLX`; boşsa tüm oda tipleri
`board`	string	Hayır	Satıştaki pansiyon kodu: ; boşsa hepsi

4 · Fiyatlar

GET /v1/rates?from=2026-09-01&to=2026-09-30

Belirtilen aralık için günlük net fiyatlarınızı döner. Fiyatlar nettir; komisyon veya indirim uygulanmaz.

5 · Rezervasyon

POST /v1/reservations

6 · Ödeme & İptal Kuralları

Web ve acente paneli için geçerli kurallar API kanalında da aynen uygulanır.

rateType	Davranış	Ödeme
`non_refundable`	İptal edilemez statüde oluşur	İstek anında `payment` zorunlu
`flexible`	Opsiyonda tutulur · `paymentDue` alanı döner	Son ödeme anına kadar sanal kart / sanal POS tetiklenmezse otomatik iptal
`flexible` (aynı gün)	Opsiyon açılmaz	İstek anında ödeme zorunlu, aksi hâlde `402`

7 · Hata Kodları

Kod	Anlamı	Çözüm
401	Geçersiz API anahtarı	Anahtarı ve Bearer biçimini kontrol edin
402	Ödeme gerekli	Aynı gün veya iade edilemez tarifede ödeme bilgisi gönderin
403	Yetkisiz tip / oda tipi	Sözleşmenizde tanımlı olmayan veri istendi
409	Kontenjan yetersiz	Müsaitliği yeniden sorgulayın
422	Stop-sale	İlgili tarihler satışa kapalı
429	Hız sınırı aşıldı	Dakikada 600 istek · geri çekilme uygulayın