Soho House API (Resmi Olmayan Teknik Kılavuz 2025)

8 Ekim 2025'te, Soho House dijital ekosistemi için kapsamlı bir Postman koleksiyonu docs.sohohousedigital.com adresinde kamuya açık olarak erişime sunuldu. İç kullanım için tasarlanmış olmasına rağmen, bu erişim, küresel bir lüks konaklama markasının dijital üyelik deneyimini nasıl inşa ettiğine dair ilginç bir pencere sunuyor.

Bu kılavuz, oda rezervasyonlarından "House Pay" fatura bölme özelliğine kadar her şeyi destekleyen teknik yığın, sahneleme ortamları ve üçüncü taraf entegrasyonlarını (Oracle Simphony, Agora, 3C) analiz ediyor. Spesifikasyonda bulunan uç noktaların, parametrelerin ve yapılandırma detaylarının tam bir referansını içerir.

Açıklama: Soho House & Co. ile bağlantılı değiliz. Bu analiz, yalnızca kamuya açık belgeler üzerine kuruludur ve eğitim ve birlikte çalışabilirlik araştırma amaçları için tasarlanmıştır.

1. Altyapı & Ortamlar

API spesifikasyonu, üretim ve sahneleme ortamları arasında net bir ayrım ortaya koymakta ve mikro hizmet tarzı bir yönlendirme mimarisi kullanmaktadır. Ayrıca, "The Ned" ve "Soho Works" gibi belirli alt markaların farklı kimlik sağlayıcıları üzerinde çalıştığını ortaya koymaktadır.

Ana Bilgisayar Adları & Hizmetler

• Üretim API: https://api.production.sohohousedigital.com
• Sahneleme API: https://api.staging.sohohousedigital.com
• The Ned (Sahneleme): https://api-ned.staging.sohohousedigital.com
• Versiyon Kontrol Hizmeti: https://vcs-master.staging.sohohousedigital.com (Kullanılır force_update kontrolleri için)
• Algolia Arama: https://MRH59RRZDT-dsn.algolia.net (Uygulama ID: MRH59RRZDT)

Kimlik Sağlayıcıları

Kimlik doğrulama, farklı markalar arasında federasyona tabi:

• Soho House: identity.houseseven.com
• The Ned: identity.thened.com
• Soho Works: identity.sohohouse.com

2. Kimlik Doğrulama & "Kamu Sırrı"

API, standart OAuth2 kullanmaktadır. Mobil uygulamalar "kamu istemcileri" olduğundan, client_id ve client_secret doğrudan uygulama koduna gömülmüştür. Postman koleksiyonu bu kimlik bilgilerini açıkça ortaya koyarak, kimlik doğrulama akışını anlamamıza olanak tanır.

Spesifikasyonda bulunan kimlik bilgileri:

client_id: "200140c7**************************************3b96fef0"
client_secret: "7362f55c4**************************************2e29018a6"

Geçit Başlıkları

Bir kullanıcı /oauth/token üzerinden giriş yaptığında, API Geçidi yukarı akış taleplerine belirli başlıklar ekler. Bu, Soho House'un her istekte veritabanını sorgulamadan çoklu mekan izinlerini nasıl yönettiğini ortaya koyar:

• X-Sh-Global-Id: Kullanıcının benzersiz UUID'si.
• X-Sh-Business-Unit: Kullanıcıları markaya göre segmentler (örneğin, sh, ned).
• X-Sh-Memberships: örn. EVERY_HOUSE, REGULAR, CITIES_WITHOUT_HOUSES.
• X-Sh-Sites: Yetkili mekan kodlarının virgülle ayrılmış listesi (örneğin, 180_HOUSE, SHD (Shoreditch), BH (Babington), GRS (Greek Street)).

3. Uç Nokta Referansı & Yapılandırma

A. Kimlik Doğrulama & Kimlik

Tüm diğer uç noktalar için gereken Bearer token'ı oluşturmak için standart OAuth2 akışları kullanılır.

Yöntem	Uç Nokta	Açıklama	Parametreler / Yük
GET	/oauth/authorize	Web Giriş Akışı	response_type=code, client_id, redirect_uri
POST	/oauth/token	Kod/kredi değişimi	grant_type (password/authorization_code), client_id, client_secret
POST	/api/v1/identities	Hesap Oluştur	email, password, first_name, last_name, phone_number
PUT	/api/v1/password	Şifre Değiştir	old_password, password, password_confirmation
GET	/api/v1/me	Eski Hesap Bilgileri	Temel ID ve yerel mekan döner

B. Hesaplar, Profiller & Üyelikler

Kullanıcının dijital kimliğini yönetmek için uç noktalar. include parametresi, arka uçta ilişkisel bir veritabanı yapısını önermektedir.

Yöntem	Uç Nokta	Açıklama	Yapılandırma / Notlar
GET	/profiles/accounts/me	Tam Hesap Detayları	include=profile,membership,local_house
PATCH	/profiles/accounts/me	Hesabı Güncelle	Adres, onaylar, telefon numarasını güncelle
GET	/profiles/profiles/me	Kamu Profil Verileri	Biyografi, sosyal hesaplar, iş unvanı döner
PATCH	/profiles/profiles/me	Profili Güncelle	Biyografi, sosyal hesaplar, meslek güncelle
GET	/profiles/memberships/me	Üyelik Durumu	Durum, başlangıç/bitiş tarihleri, personel türü (is_staff) döner
GET	/profiles/interests	İlgi Alanlarını Listele	filter[name][prefix] otomatik tamamlama için
GET	/profiles/occupations	Meslekleri Listele	filter[name][prefix] otomatik tamamlama için
GET	/profiles/membership_cards/{number}/profile	Kartla Arama	Fiziksel kart numarasını küresel bir ID'ye çözümle

C. Etkinlikler & Sinema

Ev etkinliklerini listelemek ve rezerve etmek için kapsamlı uç noktalar. Mantık, "Piyangolar" (yüksek talep gören etkinlikler) için özel bir işleme içerir.

Yöntem	Uç Nokta	Açıklama	Ana Filtreler / Parametreler
GET	/events/events	Etkinlikleri Ara	filter[location_id], filter[date][from], filter[category], filter[event_type]
GET	/events/events/{id}	Tek Etkinlik	include=venue,resource
GET	/events/event_categories	Kategorileri Listele	filter[event_type]
GET	/events/bookings	Kullanıcı Rezervasyonlarını Listele	filter[state] (rezervasyonlu/iptal), include=event,venue
POST	/events/bookings	Etkinlik Rezervasyonu	Yük: guests dizisi, event ID, payment_card ID
DELETE	/events/bookings/{id}	Rezervasyonu İptal Et	N/A

D. Odalar (Otel Rezervasyonu)

rooms uç noktaları, oda türleri ve fiyat planları için dahili kodları ortaya koyar. days uç noktası, ham fiyat takvimini ortaya koyması açısından özellikle ilginçtir.

Yöntem	Uç Nokta	Açıklama	İçeriden Notlar / Parametreler
GET	/rooms/hotels	Otelleri Listele	Rezervasyon URL'leri ve vergi bilgileri döner
GET	/rooms/availabilities	Odaları Ara	filter[rate_plan_type] (örneğin, MEMBER_RATE, FRIENDS)
GET	/rooms/days	Fiyat Takvimi	Oda kodlarını açığa çıkarır: TINY, SMALL, MEDM, LARG
GET	/rooms/room_bookings	Rezervasyonları Listele	filter[status], filter[starts_at][from]
POST	/rooms/room_bookings	Rezervasyon Oluştur	Yük: address, dates, availability_rate ID
PATCH	/rooms/room_bookings/{id}	Rezervasyonu Değiştir	Tarihleri veya misafir sayısını değiştir

E. House Pay (Faturalar & Simphony Entegrasyonu)

Bu bölüm, Oracle Micros Simphony ile sıkı bir entegrasyonu ortaya koymaktadır. API, üyelerin restoran faturalarını doğrudan ödemesine olanak tanır. Üyenin dosyasına karşı kontrolleri otomatik olarak kapatmak için muhtemelen kullanılan özel bir "Walkout" uç noktası içerir.

Yöntem	Uç Nokta	Açıklama	İçeriden Notlar
GET	/checks/public/checks	Açık Kontrol Listesi	filter['status']=open
GET	/checks/public/checks/{id}	Kontrol Detaylarını Al	Ürünler, vergi, hizmet ücreti döner
POST	/checks/public/payments	Kontrolü Öde	Yük: check_id, amount_cents, card_id, tip_amount_cents
POST	/checks/public/payments/walkout	Walkout Ödemesi	Kontrolü zorla kapatmak için simphony_manager_id kullanır
POST	/checks/public/checks/{id}/discount	İndirim Uygula	Yük: discount_id (örneğin U27 oranları)
POST	/checks/public/checks/{id}/email	Faturayı E-posta Gönder	PDF fatura e-postasını tetikler
GET	/payments/cards	Kartları Listele	filter[venue] (genellikle 'GRS' olarak kodlanmıştır)

F. Masalar (Restoran Rezervasyonu)

API, ödeme sürecinde çift rezervasyonu önlemek için bir "Kilitleme" mekanizması kullanmaktadır.

Yöntem	Uç Nokta	Açıklama	İçeriden Notlar
GET	/tables/availabilities	Slotları Ara	filter[restaurant_id] (örneğin, SH_SIXTH_FLOOR_RESTAURANTS)
POST	/tables/locks	Masayı Kilitle	Kullanıcının rezervasyonu tamamlaması sırasında bir slotu x dakika kilitler
POST	/tables/table_bookings	Rezervasyonu Onayla	Geçerli table_lock ID'si gerektirir

G. Bağlan & Sohbet (Agora Entegrasyonu)

"House Connect" özellikleri, Agora'yı gerçek zamanlı iletişim için kullanmakta olup, agora_id parametresi ile kanıtlanmaktadır.

Yöntem	Uç Nokta	Açıklama	Notlar
GET	/connect/checkins	Duyuru Panosu	filter[venue_id] ile bir evde kimlerin olduğunu görmek için
POST	/connect/checkins	Duyuru Panosuna Gönder	Yük: status, venue_id
GET	/chat/timeslots	Sohbet Uygunluğu	"House Connect" için açık slotları listele
POST	/chat/chat_tokens	Sohbet Token'ı Al	Stream/Agora entegrasyonu için token döner
POST	/chat/rooms/{id}/room_accesses	Odaya Katıl	Yük, agora_id içerir

H. Üyelik Başvuruları

Kaydolma akışı sırasında kullanılan uç noktalar, ödemeler için Braintree entegrasyonu dahil.

Yöntem	Uç Nokta	Açıklama
GET	/applications	Kullanıcının başvurularını listele
POST	/applications	Yeni başvuru gönder
POST	/applications/{id}/attachments	Kimlik/Profil Resmi Yükle
GET	/products	Üyelik Ürünlerini Listele

I. İçerik & Editoryal

Uygulama içeriği, ev notları ve statik sayfalar için yalnızca okunabilir uç noktalar.

Yöntem	Uç Nokta	Açıklama	Ana Filtreler
GET	/content/house_notes	Editoryal İçerik	filter[venue_id], filter[content_category_id]
GET	/content/perks	Üye Avantajları	filter[region]
GET	/content/house_rules	Ev Kuralları	filter[venue_id]
GET	/content/house_tours	Ev Turları	filter[venue_id]

J. Sistem Kontrolü

Yöntem	Uç Nokta	Açıklama
GET	/force_update	Uygulama sürümü bir eski listeyle eşleşirse 426 Upgrade Required döner, kullanıcıları App Store'dan güncellemeye zorlar.

Sonuç

Soho House API, JSON:API standartlarının karmaşık bir uygulamasıdır ve eski POS sistemlerini (Simphony), modern gerçek zamanlı teknolojiyi (Agora) ve küresel kimlik yönetimini bir araya getirmektedir. Geliştiriciler için, eski konaklama sistemlerini modern, mobil öncelikli bir REST API'sine nasıl saracaklarına dair bir ustalık dersi sunmaktadır.

---

Açıklama: Bu analiz, Ekim 2025'te kamuya açık olarak mevcut belgelerin bir anlık görüntüsüne dayanmaktadır.