Concepts

Hotels

Oteller ve tanıtım rehberleri yalnızca programdaki güvenli görüntü alanlarıdır.

Server-to-server

HotelStay

Field	Type		Description
`name`	string \| null	optional
`location`	string \| null	optional
`checkIn`	string \| null	optional
`checkOut`	string \| null	optional
`destination`	string \| null	optional	Canonical stay destination when derivable
`duration`	Duration	optional	Inclusive stay day/night count derived from checkIn/checkOut
`coverUrl`	string \| null	optional	Public hotel cover image URL from hotel catalog when available
`galleryUrls`	array<string>	optional	Public hotel gallery URLs from hotel catalog when available
`starLevel`	integer \| null	optional	Public hotel star rating when available

Field	Type		Description
`type`	string \| null	optional
`subtype`	string \| null	optional

PublicGuides

guides yalnızca programın tanıtım içeriğindeki rehberlerden gelir. Operasyonel personel, hoca veya rehber atamaları yayımlanmaz.

Field	Type		Description
`male`	PublicGuide	optional
`female`	PublicGuide	optional

PublicGuide

Field	Type		Description
`name`	string	optional	Public guide display name
`title`	string \| null	optional	Optional public title (e.g. Rehber, Hanim Rehber)
`photoUrl`	string \| null	optional	Public photo URL from program tanitim content

Accommodation

Field	Type		Description
`stays`	array<HotelStay>	optional	Public hotel stays including starLevel when available
`description`	string \| null	optional	Public accommodation description

Transport

Field	Type		Description
`flights`	array<ProgramFlight>	optional	Assigned round-trip flight packages with public airline branding and leg details

AirlineBrand

Field	Type		Description
`code`	string	required	Public airline code
`name`	string \| null	optional	Public airline display name when available
`logoUrl`	string \| null	optional	Stable HTTPS URL for the airline SVG logo served from `https://sefera-api.web.app/v1/assets/airlines/{catalog-id}.svg` when the airline matches the Sefera canonical catalog (Turkish Airlines, AJet, Saudia, Pegasus). Returns `null` when the airline is unknown or no hosted logo exists — consumers must not render a broken image for `null`.

PublicMedia

Field	Type		Description
`coverUrl`	string \| null	optional	Public cover image URL
`galleryUrls`	array<string>	optional	Public gallery image URLs

PublicContent

Field	Type		Description
`programDescription`	string \| null	optional	Public program description (also mirrored at top-level description on detail)
`included`	array<string>	optional	Included services
`excluded`	array<string>	optional	Excluded services
`visits`	array<string>	optional	Public visit/place names
`accommodationDescription`	string \| null	optional	Public accommodation description
`faq`	array<object>	optional	Public program FAQ
`itinerary`	array<object>	optional	Public itinerary. Raw dailyPlan is never published.

Otel kataloğu veya rehber kataloğu birleştirilmez. Yalnızca programdaki güvenli görüntü alanları yayımlanır. Ham dailyPlan, otel telefon/adres ve operasyonel notlar dönmez.