Soho House API (Uofficiel Teknisk Guide 2025)

Den 8. oktober 2025 blev en omfattende Postman-samling for Soho House digitale økosystem offentliggjort på docs.sohohousedigital.com. Selvom den er beregnet til intern brug, tilbyder dens tilgængelighed et fascinerende indblik i, hvordan et globalt luksushotelselskab designer sin digitale medlemsoplevelse.

Denne guide analyserer den tekniske stak, staging-miljøer og tredjepartsintegrationer (Oracle Simphony, Agora, 3C), der driver alt fra værelsesreservationer til "House Pay" regningssplittende funktion. Den inkluderer en komplet reference til endpoints, parametre og konfigurationsdetaljer, der findes inden for specifikationen.

Ansvarsfraskrivelse: Vi er ikke tilknyttet Soho House & Co. Denne analyse er udelukkende baseret på offentligt tilgængelig dokumentation og er beregnet til uddannelsesmæssige og interoperabilitetsforskningsformål.

1. Infrastruktur & Miljøer

API-specifikationen afslører en klar adskillelse mellem produktions- og staging-miljøer, der udnytter en mikroservices-stil routingarkitektur. Den afslører også specifikke sub-brands som "The Ned" og "Soho Works", der opererer på forskellige identitetsudbydere.

Værtsnavne & Tjenester

• Produktions-API: https://api.production.sohohousedigital.com
• Staging-API: https://api.staging.sohohousedigital.com
• The Ned (Staging): https://api-ned.staging.sohohousedigital.com
• Versionskontroltjeneste: https://vcs-master.staging.sohohousedigital.com (Bruges til force_update tjek)
• Algolia Søgning: https://MRH59RRZDT-dsn.algolia.net (App ID: MRH59RRZDT)

Identitetsudbydere

Godkendelse er fødereret på tværs af forskellige brands:

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

2. Godkendelse & Den "Offentlige Hemmelighed"

API'en bruger standard OAuth2. Fordi mobilapps er "offentlige klienter", er client_id og client_secret indlejret direkte i applikationskoden. Postman-samlingen afslører eksplicit disse legitimationsoplysninger, hvilket giver os mulighed for at forstå godkendelsesflowet.

Legitimationsoplysninger fundet i spec:

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

Gateway-overskrifter

Når en bruger logger ind via /oauth/token, injicerer API Gateway specifikke overskrifter i upstream-anmodninger. Dette afslører, hvordan Soho House håndterer multi-venue tilladelser uden at forespørge databasen ved hver anmodning:

• X-Sh-Global-Id: Brugerens unikke UUID.
• X-Sh-Business-Unit: Segmenterer brugere efter brand (f.eks. sh, ned).
• X-Sh-Memberships: f.eks. EVERY_HOUSE, REGULAR, CITIES_WITHOUT_HOUSES.
• X-Sh-Sites: En kommasepareret liste over autoriserede venue-koder (f.eks. 180_HOUSE, SHD (Shoreditch), BH (Babington), GRS (Greek Street)).

3. Endpoint-reference & Konfiguration

A. Godkendelse & Identitet

Standard OAuth2 flows bruges til at generere Bearer-tokenet, der kræves for alle andre endpoints.

Metode	Endpoint	Beskrivelse	Params / Payload
GET	/oauth/authorize	Web Login Flow	response_type=code, client_id, redirect_uri
POST	/oauth/token	Udveksle kode/legitimationsoplysninger	grant_type (password/authorization_code), client_id, client_secret
POST	/api/v1/identities	Opret konto	email, password, first_name, last_name, phone_number
PUT	/api/v1/password	Skift adgangskode	old_password, password, password_confirmation
GET	/api/v1/me	Legacy kontooplysninger	Returnerer grundlæggende ID og lokal venue

B. Konti, profiler & Medlemskaber

Endpoints til at administrere brugerens digitale identitet. include parameteren antyder en relationsdatabase-struktur på backend.

Metode	Endpoint	Beskrivelse	Konfiguration / Noter
GET	/profiles/accounts/me	Fuld kontooplysninger	include=profile,membership,local_house
PATCH	/profiles/accounts/me	Opdater konto	Opdater adresse, samtykker, telefonnummer
GET	/profiles/profiles/me	Offentlige profildata	Returnerer bio, sociale håndtag, jobtitel
PATCH	/profiles/profiles/me	Opdater profil	Opdater bio, sociale håndtag, erhverv
GET	/profiles/memberships/me	Medlemsstatus	Returnerer status, start/slut datoer, medarbejdertype (is_staff)
GET	/profiles/interests	Liste over interesser	filter[name][prefix] til autocomplete
GET	/profiles/occupations	Liste over erhverv	filter[name][prefix] til autocomplete
GET	/profiles/membership_cards/{number}/profile	Opslag efter kort	Omsætter et fysisk kortnummer til et globalt ID

C. Begivenheder & Biograf

Omfattende endpoints til at liste og booke husbegivenheder. Logikken inkluderer specifik håndtering for "Lotterier" (højt efterspurgte begivenheder).

Metode	Endpoint	Beskrivelse	Nøglefiltre / Params
GET	/events/events	Søg begivenheder	filter[location_id], filter[date][from], filter[category], filter[event_type]
GET	/events/events/{id}	Enkelt begivenhed	include=venue,resource
GET	/events/event_categories	Liste over kategorier	filter[event_type]
GET	/events/bookings	Liste over brugerbookinger	filter[state] (booket/annulleret), include=event,venue
POST	/events/bookings	Book begivenhed	Payload: guests array, event ID, payment_card ID
DELETE	/events/bookings/{id}	Annuller booking	N/A

D. Værelser (Hotelbooking)

rooms endpoints afslører interne koder for værelsestyper og prisplaner. days endpointet er særligt interessant, da det afslører den rå pris kalender.

Metode	Endpoint	Beskrivelse	Insider Noter / Params
GET	/rooms/hotels	Liste over hoteller	Returnerer booking-URL'er og skatteoplysninger
GET	/rooms/availabilities	Søg værelser	filter[rate_plan_type] (f.eks. MEMBER_RATE, FRIENDS)
GET	/rooms/days	Priskalender	Afslører værelseskoder: TINY, SMALL, MEDM, LARG
GET	/rooms/room_bookings	Liste over bookinger	filter[status], filter[starts_at][from]
POST	/rooms/room_bookings	Opret booking	Payload: address, dates, availability_rate ID
PATCH	/rooms/room_bookings/{id}	Ændre booking	Ændre datoer eller gæstetællinger

E. House Pay (Regninger & Simphony Integration)

Denne sektion afslører en tæt integration med Oracle Micros Simphony. API'en giver medlemmer mulighed for at betale restaurantregninger direkte. Den inkluderer et specifikt "Walkout" endpoint, der sandsynligvis bruges til automatisk at afslutte regninger mod en medlemsfil.

Metode	Endpoint	Beskrivelse	Insider Noter
GET	/checks/public/checks	Liste over åbne regninger	filter['status']=open
GET	/checks/public/checks/{id}	Få regningsoplysninger	Returnerer varer, skat, servicegebyr
POST	/checks/public/payments	Betal regning	Payload: check_id, amount_cents, card_id, tip_amount_cents
POST	/checks/public/payments/walkout	Walkout-betaling	Bruger simphony_manager_id til at tvinge lukning af regning
POST	/checks/public/checks/{id}/discount	Anvend rabat	Payload: discount_id (f.eks. U27 priser)
POST	/checks/public/checks/{id}/email	Email kvittering	Udløser PDF kvitterings-email
GET	/payments/cards	Liste over kort	filter[venue] (normalt hardcoded 'GRS')

F. Tabel (Restaurantbooking)

API'en bruger en "Lock" mekanisme for at forhindre dobbeltbooking under checkout-processen.

Metode	Endpoint	Beskrivelse	Insider Noter
GET	/tables/availabilities	Søg slots	filter[restaurant_id] (f.eks. SH_SIXTH_FLOOR_RESTAURANTS)
POST	/tables/locks	Lås bord	Låser en slot i x minutter, mens brugeren afslutter booking
POST	/tables/table_bookings	Bekræft booking	Kræver gyldig table_lock ID

G. Connect & Chat (Agora Integration)

"House Connect" funktionerne udnytter Agora til realtidskommunikation, bevidnet ved agora_id parameteren.

Metode	Endpoint	Beskrivelse	Noter
GET	/connect/checkins	Opslagstavle	filter[venue_id] for at se, hvem der er i et hus
POST	/connect/checkins	Post til opslagstavlen	Payload: status, venue_id
GET	/chat/timeslots	Chat-tilgængelighed	Liste over åbne slots for "House Connect"
POST	/chat/chat_tokens	Få chat-token	Returnerer token til Stream/Agora integration
POST	/chat/rooms/{id}/room_accesses	Deltag i rum	Payload inkluderer agora_id

H. Medlemsansøgninger

Endpoints brugt under tilmeldingsflowet, inklusive Braintree integration til betalinger.

Metode	Endpoint	Beskrivelse
GET	/applications	Liste over brugerens ansøgninger
POST	/applications	Indsend ny ansøgning
POST	/applications/{id}/attachments	Upload ID/Headshot
GET	/products	Liste over medlemsprodukter

I. Indhold & Redaktion

Læsebeskyttede endpoints for appindhold, husnoter og statiske sider.

Metode	Endpoint	Beskrivelse	Nøglefiltre
GET	/content/house_notes	Redaktionsindhold	filter[venue_id], filter[content_category_id]
GET	/content/perks	Medlemsfordele	filter[region]
GET	/content/house_rules	Husregler	filter[venue_id]
GET	/content/house_tours	Husbesøg	filter[venue_id]

J. Systemkontrol

Metode	Endpoint	Beskrivelse
GET	/force_update	Returnerer 426 Upgrade Required, hvis appversionen matcher en forældet liste, hvilket tvinger brugere til at opdatere via App Store.

Konklusion

Soho House API'en er en sofistikeret implementering af JSON:API-standarder, der orkestrerer et komplekst netværk af ældre POS-systemer (Simphony), moderne realtids-teknologi (Agora) og global identitetsstyring. For udviklere fungerer det som en mesterklasse i, hvordan man indpakker ældre hotel-systemer i en moderne, mobil-først REST API.

---

Ansvarsfraskrivelse: Denne analyse er baseret på et snapshot af dokumentation, der var offentligt tilgængelig i oktober 2025.