Soho House API (Inofficiell Teknisk Guide 2025)

Den 8 oktober 2025 publicerades en omfattande Postman-samling för Soho House digitala ekosystem på docs.sohohousedigital.com. Även om den är avsedd för internt bruk, erbjuder dess tillgänglighet en fascinerande inblick i hur ett globalt lyxhotell varumärke arkitekterar sin digitala medlemsupplevelse.

Denna guide analyserar den tekniska stacken, stagingmiljöerna och tredjepartsintegrationerna (Oracle Simphony, Agora, 3C) som driver allt från rumsbokningar till "House Pay"-funktionen för delning av räkningar. Den innehåller en komplett referens av slutpunkter, parametrar och konfigurationsdetaljer som finns i specifikationen.

Ansvarsfriskrivning: Vi är inte kopplade till Soho House & Co. Denna analys baseras strikt på offentligt tillgänglig dokumentation och är avsedd för utbildnings- och interoperabilitetsforskningsändamål.

1. Infrastruktur & Miljöer

API-specifikationen avslöjar en tydlig separation mellan produktions- och stagingmiljöer, som använder en mikrotjänst-stil routingarkitektur. Den exponerar också specifika sub-varumärken som "The Ned" och "Soho Works" som verkar på distinkta identitetsleverantörer.

Värdnamn & Tjänster

• Produktions-API: https://api.production.sohohousedigital.com
• Staging-API: https://api.staging.sohohousedigital.com
• The Ned (Staging): https://api-ned.staging.sohohousedigital.com
• Versionskontrolltjänst: https://vcs-master.staging.sohohousedigital.com (Används för force_update kontroller)
• Algolia Sökning: https://MRH59RRZDT-dsn.algolia.net (App ID: MRH59RRZDT)

Identitetsleverantörer

Autentisering är federerad över olika varumärken:

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

2. Autentisering & "Offentlig Hemlighet"

API:et använder standard OAuth2. Eftersom mobilapparna är "offentliga klienter" är client_id och client_secret inbäddade direkt i applikationskoden. Postman-samlingen exponerar explicit dessa autentiseringsuppgifter, vilket gör att vi kan förstå autentiseringsflödet.

Uppgifter som finns i specifikationen:

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

Gateway-Headers

När en användare loggar in via /oauth/token, injicerar API Gateway specifika headers i uppströmsförfrågningar. Detta avslöjar hur Soho House hanterar multi-venue-behörigheter utan att fråga databasen vid varje förfrågan:

• X-Sh-Global-Id: Användarens unika UUID.
• X-Sh-Business-Unit: Segmenterar användare efter varumärke (t.ex. sh, ned).
• X-Sh-Memberships: t.ex. EVERY_HOUSE, REGULAR, CITIES_WITHOUT_HOUSES.
• X-Sh-Sites: En kommaseparerad lista över auktoriserade platskoder (t.ex. 180_HOUSE, SHD (Shoreditch), BH (Babington), GRS (Greek Street)).

3. Slutpunktsreferens & Konfiguration

A. Autentisering & Identitet

Standard OAuth2-flöden används för att generera Bearer-token som krävs för alla andra slutpunkter.

Metod	Slutpunkt	Beskrivning	Parametrar / Payload
GET	/oauth/authorize	Webbautentiseringsflöde	response_type=code, client_id, redirect_uri
POST	/oauth/token	Byt kod/autentiseringsuppgifter	grant_type (password/authorization_code), client_id, client_secret
POST	/api/v1/identities	Skapa konto	email, password, first_name, last_name, phone_number
PUT	/api/v1/password	Ändra lösenord	old_password, password, password_confirmation
GET	/api/v1/me	Legacy-kontoinformation	Returnerar grundläggande ID och lokal plats

B. Konton, profiler & medlemskap

Slutpunkter för att hantera användarens digitala identitet. Parametern include antyder en relationsdatabasstruktur på backend.

Metod	Slutpunkt	Beskrivning	Konfiguration / Noter
GET	/profiles/accounts/me	Fullständiga kontouppgifter	include=profile,membership,local_house
PATCH	/profiles/accounts/me	Uppdatera konto	Uppdatera adress, samtycken, telefonnummer
GET	/profiles/profiles/me	Offentlig profilinformation	Returnerar bio, sociala konton, jobbtitel
PATCH	/profiles/profiles/me	Uppdatera profil	Uppdatera bio, sociala konton, yrke
GET	/profiles/memberships/me	Medlemsstatus	Returnerar status, start/slutdatum, personaltyp (is_staff)
GET	/profiles/interests	Lista intressen	filter[name][prefix] för autocomplet
GET	/profiles/occupations	Lista yrken	filter[name][prefix] för autocomplet
GET	/profiles/membership_cards/{number}/profile	Sök med kort	Kopplar ett fysiskt kortnummer till ett globalt ID

C. Evenemang & Bio

Omfattande slutpunkter för att lista och boka husets evenemang. Logiken inkluderar specifik hantering för "Lotterier" (hög efterfrågan).

Metod	Slutpunkt	Beskrivning	Nyckelfilter / Parametrar
GET	/events/events	Sök evenemang	filter[location_id], filter[date][from], filter[category], filter[event_type]
GET	/events/events/{id}	Enskilt evenemang	include=venue,resource
GET	/events/event_categories	Lista kategorier	filter[event_type]
GET	/events/bookings	Lista användarbokningar	filter[state] (bokad/avbokad), include=event,venue
POST	/events/bookings	Boka evenemang	Payload: guests array, event ID, payment_card ID
DELETE	/events/bookings/{id}	Avboka bokning	N/A

D. Rum (Hotellbokning)

Slutpunkterna för rooms avslöjar interna koder för rumstyper och prisplaner. days slutpunkten är särskilt intressant eftersom den exponerar den råa priskalendern.

Metod	Slutpunkt	Beskrivning	Insider Noter / Parametrar
GET	/rooms/hotels	Lista hotell	Returnerar boknings-URL:er och skatteinformation
GET	/rooms/availabilities	Sök rum	filter[rate_plan_type] (t.ex. MEMBER_RATE, FRIENDS)
GET	/rooms/days	Priskalender	Exponerar rumskoder: TINY, SMALL, MEDM, LARG
GET	/rooms/room_bookings	Lista bokningar	filter[status], filter[starts_at][from]
POST	/rooms/room_bookings	Skapa bokning	Payload: address, dates, availability_rate ID
PATCH	/rooms/room_bookings/{id}	Ändra bokning	Ändra datum eller gästantal

E. House Pay (Kvitton & Simphony-integration)

Detta avsnitt avslöjar en nära integration med Oracle Micros Simphony. API:et tillåter medlemmar att betala restaurangräkningar direkt. Det inkluderar en specifik "Walkout"-slutpunkt, som sannolikt används för att automatiskt stänga kvitton mot en medlems fil.

Metod	Slutpunkt	Beskrivning	Insider Noter
GET	/checks/public/checks	Lista öppna kvitton	filter['status']=open
GET	/checks/public/checks/{id}	Hämta kvittodetaljer	Returnerar varor, skatt, serviceavgift
POST	/checks/public/payments	Betala kvitto	Payload: check_id, amount_cents, card_id, tip_amount_cents
POST	/checks/public/payments/walkout	Walkout-betalning	Använder simphony_manager_id för att tvinga stängning av kvitto
POST	/checks/public/checks/{id}/discount	Tillämpa rabatt	Payload: discount_id (t.ex. U27 priser)
POST	/checks/public/checks/{id}/email	E-posta kvitto	Utlöser PDF-kvitto via e-post
GET	/payments/cards	Lista kort	filter[venue] (vanligtvis hårdkodad 'GRS')

F. Bord (Restaurangbokning)

API:et använder en "Lås"-mekanism för att förhindra dubbelbokning under bokningsprocessen.

Metod	Slutpunkt	Beskrivning	Insider Noter
GET	/tables/availabilities	Sök platser	filter[restaurant_id] (t.ex. SH_SIXTH_FLOOR_RESTAURANTS)
POST	/tables/locks	Lås bord	Låser en plats i x minuter medan användaren slutför bokningen
POST	/tables/table_bookings	Bekräfta bokning	Kräver giltigt table_lock ID

G. Anslut & Chat (Agora-integration)

Funktionerna "House Connect" använder Agora för realtidskommunikation, vilket bevisas av agora_id-parametern.

Metod	Slutpunkt	Beskrivning	Noter
GET	/connect/checkins	Anslagstavla	filter[venue_id] för att se vem som är på ett hus
POST	/connect/checkins	Posta till anslagstavlan	Payload: status, venue_id
GET	/chat/timeslots	Chatttillgänglighet	Lista öppna tider för "House Connect"
POST	/chat/chat_tokens	Hämta chatt-token	Returnerar token för Stream/Agora-integration
POST	/chat/rooms/{id}/room_accesses	Gå med i rum	Payload inkluderar agora_id

H. Medlemsansökningar

Slutpunkter som används under registreringsflödet, inklusive Braintree-integration för betalningar.

Metod	Slutpunkt	Beskrivning
GET	/applications	Lista användarens ansökningar
POST	/applications	Skicka ny ansökan
POST	/applications/{id}/attachments	Ladda upp ID/Porträtt
GET	/products	Lista medlemsprodukter

I. Innehåll & Redaktion

Skrivskyddade slutpunkter för appinnehåll, husnoter och statiska sidor.

Metod	Slutpunkt	Beskrivning	Nyckelfilter
GET	/content/house_notes	Editorialt innehåll	filter[venue_id], filter[content_category_id]
GET	/content/perks	Medlemsförmåner	filter[region]
GET	/content/house_rules	Husregler	filter[venue_id]
GET	/content/house_tours	Husbesök	filter[venue_id]

J. Systemkontroll

Metod	Slutpunkt	Beskrivning
GET	/force_update	Returnerar 426 Upgrade Required om appversionen matchar en avlistad version, vilket tvingar användare att uppdatera via App Store.

Slutsats

Soho House API är en sofistikerad implementering av JSON:API-standarder, som orkestrerar ett komplext nätverk av äldre POS-system (Simphony), modern realtids-teknik (Agora) och global identitetshantering. För utvecklare fungerar det som en mästarklass i hur man sveper in äldre hotellssystem i en modern, mobil-först REST API.

---

Ansvarsfriskrivning: Denna analys baseras på en ögonblicksbild av dokumentation som var offentligt tillgänglig i oktober 2025.