Soho House API (Resmi Olmayan Teknik Kılavuz 2025)
Soho House dijital ekosistemine kapsamlı bir teknik derin dalış. 2025 kamu API spesifikasyonunda ortaya çıkan 'House Pay', Oda Rezervasyonları ve Üye Bağlantıları arka planındaki sahneleme ortamlarını, üçüncü taraf entegrasyonlarını (Oracle Simphony, Agora, Algolia) analiz ediyoruz.
The Tech Insider
Author
The Tech Insider

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ırforce_updatekontrolleri 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.
Referanslar & Alıntılar
Editoryal Açıklama
Bu makale bağımsız bir yayındır. Soho House & Co. ile bağlantılı değiliz. Bilgiler kamu kaynaklarına ve yorum ve eleştiri için adil kullanım ilkelerine dayanmaktadır. Hiçbir onay ima edilmemektedir.
