מדריך טכני לא רשמי של Soho House API 2025

ב-8 באוקטובר 2025, אוסף Postman מקיף עבור המערכת הדיגיטלית של Soho House הושק לציבור בכתובת docs.sohohousedigital.com. בעוד שהמטרה היא שימוש פנימי, זמינותו מציעה חלון מרהיב לתוך האופן שבו מותג יוקרה גלובלי מעצב את חוויית החברות הדיגיטלית שלו.

מדריך זה מנתח את הסטאק הטכני, סביבות הבמה ואינטגרציות צד שלישי (Oracle Simphony, Agora, 3C) שמניעות הכל מהזמנת חדרים ועד לפיצ'ר חלוקת החשבון "House Pay". הוא כולל הפניה מלאה של נקודות קצה, פרמטרים ופרטי תצורה שנמצאו במפרט.

הבהרה: אנו לא קשורים ל-Soho House & Co. ניתוח זה מתבסס אך ורק על תיעוד הנגיש לציבור ומיועד למטרות חינוך ומחקר על יכולת פעולה הדדית.

1. תשתית וסביבות

המפרט של ה-API חושף הפרדה ברורה בין סביבות ייצור וסביבות הבמה, תוך שימוש באדריכלות ניתוב בסגנון מיקרו-שירותים. הוא גם חושף תתי מותגים ספציפיים כמו "The Ned" ו"Soho Works" הפועלים על ספקי זהות שונים.

שמות דומיינים ושירותים

• API ייצור: https://api.production.sohohousedigital.com
• API הבמה: https://api.staging.sohohousedigital.com
• The Ned (במה): https://api-ned.staging.sohohousedigital.com
• שירות ניהול גרסאות: https://vcs-master.staging.sohohousedigital.com (משמש לבדיקות force_update)
• חיפוש Algolia: https://MRH59RRZDT-dsn.algolia.net (מזהה אפליקציה: MRH59RRZDT)

ספקי זהות

אימות מתבצע באופן פדרלי בין מותגים שונים:

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

2. אימות וה"סוד הציבורי"

ה-API משתמש ב-OAuth2 סטנדרטי. מכיוון שהאפליקציות הניידות הן "לקוחות ציבוריים", ה-client_id וה-client_secret משובצים ישירות בקוד האפליקציה. אוסף ה-Postman חושף במפורש את האישורים הללו, ומאפשר לנו להבין את זרימת האימות.

אישורים שנמצאו במפרט:

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

כותרות השער

ברגע שמשתמש מתחבר דרך /oauth/token, שער ה-API מזריק כותרות ספציפיות לבקשות עליונות. זה חושף כיצד Soho House מנהלת הרשאות בין מקומות שונים מבלי לשאול את מסד הנתונים בכל בקשה:

• X-Sh-Global-Id: ה-UUID הייחודי של המשתמש.
• X-Sh-Business-Unit: מחלק את המשתמשים לפי מותג (למשל, sh, ned).
• X-Sh-Memberships: למשל, EVERY_HOUSE, REGULAR, CITIES_WITHOUT_HOUSES.
• X-Sh-Sites: רשימה מופרדת בפסיקים של קודי מקומות מורשים (למשל, 180_HOUSE, SHD (שורת דיץ'), BH (בבינגטון), GRS (רחוב יווני)).

3. הפניה לנקודות קצה ותצורה

א. אימות וזהות

זרימות OAuth2 סטנדרטיות משמשות ליצירת טוקן Bearer הנדרש לכל שאר נקודות הקצה.

שיטה	נקודת קצה	תיאור	פרמטרים / Payload
GET	/oauth/authorize	זרימת התחברות באינטרנט	response_type=code, client_id, redirect_uri
POST	/oauth/token	החלפת קוד/אישורים	grant_type (password/authorization_code), client_id, client_secret
POST	/api/v1/identities	יצירת חשבון	email, password, first_name, last_name, phone_number
PUT	/api/v1/password	שינוי סיסמה	old_password, password, password_confirmation
GET	/api/v1/me	מידע על חשבון ישן	מחזיר ID בסיסי ומקום מקומי

ב. חשבונות, פרופילים וחברויות

נקודות קצה לניהול הזהות הדיגיטלית של המשתמש. הפרמטר include מציע מבנה מסד נתונים יחסי בצד השרת.

שיטה	נקודת קצה	תיאור	תצורה / הערות
GET	/profiles/accounts/me	פרטי חשבון מלאים	include=profile,membership,local_house
PATCH	/profiles/accounts/me	עדכון חשבון	עדכון כתובת, הסכמות, מספר טלפון
GET	/profiles/profiles/me	נתוני פרופיל ציבורי	מחזיר ביוגרפיה, ידיות חברתיות, תפקיד
PATCH	/profiles/profiles/me	עדכון פרופיל	עדכון ביוגרפיה, ידיות חברתיות, מקצוע
GET	/profiles/memberships/me	מצב חברתי	מחזיר מצב, תאריכי התחלה/סיום, סוג צוות (is_staff)
GET	/profiles/interests	רשימת תחומי עניין	filter[name][prefix] להשלמה אוטומטית
GET	/profiles/occupations	רשימת מקצועות	filter[name][prefix] להשלמה אוטומטית
GET	/profiles/membership_cards/{number}/profile	חיפוש לפי כרטיס	פותר מספר כרטיס פיזי ל-ID גלובלי

ג. אירועים וקולנוע

נקודות קצה מקיפות לרשימה והזמנה של אירועי הבית. הלוגיקה כוללת טיפול ספציפי ל"הגרלות" (אירועים בעלי ביקוש גבוה).

שיטה	נקודת קצה	תיאור	מסננים / פרמטרים מרכזיים
GET	/events/events	חיפוש אירועים	filter[location_id], filter[date][from], filter[category], filter[event_type]
GET	/events/events/{id}	אירוע בודד	include=venue,resource
GET	/events/event_categories	רשימת קטגוריות	filter[event_type]
GET	/events/bookings	רשימת הזמנות משתמש	filter[state] (מוזמן/בוטל), include=event,venue
POST	/events/bookings	הזמנת אירוע	Payload: מערך guests, מזהה event, מזהה payment_card
DELETE	/events/bookings/{id}	ביטול הזמנה	N/A

ד. חדרים (הזמנת מלון)

נקודות הקצה rooms חושפות קודים פנימיים לסוגי חדרים ותוכניות תעריפים. נקודת הקצה days מעניינת במיוחד מכיוון שהיא חושפת את לוח המחירים הגולמי.

שיטה	נקודת קצה	תיאור	הערות פנימיות / פרמטרים
GET	/rooms/hotels	רשימת מלונות	מחזיר כתובות הזמנה ומידע על מסים
GET	/rooms/availabilities	חיפוש חדרים	filter[rate_plan_type] (למשל, MEMBER_RATE, FRIENDS)
GET	/rooms/days	לוח תעריפים	חושף קודי חדרים: TINY, SMALL, MEDM, LARG
GET	/rooms/room_bookings	רשימת הזמנות	filter[status], filter[starts_at][from]
POST	/rooms/room_bookings	יצירת הזמנה	Payload: address, dates, מזהה availability_rate
PATCH	/rooms/room_bookings/{id}	שינוי הזמנה	שינוי תאריכים או מספר אורחים

ה. House Pay (צ'קים ואינטגרציה עם Simphony)

חלק זה חושף אינטגרציה הדוקה עם Oracle Micros Simphony. ה-API מאפשר לחברים לשלם חשבונות מסעדה ישירות. הוא כולל נקודת קצה ספציפית "Walkout", ככל הנראה משמשת לסגירת צ'קים אוטומטית נגד תיק של חבר.

שיטה	נקודת קצה	תיאור	הערות פנימיות
GET	/checks/public/checks	רשימת צ'קים פתוחים	filter['status']=open
GET	/checks/public/checks/{id}	קבלת פרטי צ'ק	מחזיר פריטים, מסים, דמי שירות
POST	/checks/public/payments	תשלום צ'ק	Payload: check_id, amount_cents, card_id, tip_amount_cents
POST	/checks/public/payments/walkout	תשלום Walkout	משתמש ב-simphony_manager_id כדי לסגור צ'ק בכוח
POST	/checks/public/checks/{id}/discount	החלת הנחה	Payload: discount_id (למשל, תעריפי U27)
POST	/checks/public/checks/{id}/email	שליחת קבלה בדואר אלקטרוני	מפעיל דוא"ל קבלה בפורמט PDF
GET	/payments/cards	רשימת כרטיסים	filter[venue] (בדרך כלל קבוע 'GRS')

ו. שולחנות (הזמנת מסעדה)

ה-API משתמש במנגנון "נעילה" כדי למנוע הזמנות כפולות במהלך תהליך הצ'ק-אאוט.

שיטה	נקודת קצה	תיאור	הערות פנימיות
GET	/tables/availabilities	חיפוש זמינות	filter[restaurant_id] (למשל, SH_SIXTH_FLOOR_RESTAURANTS)
POST	/tables/locks	נעילת שולחן	נעילה של מקום למשך x דקות בזמן שהמשתמש משלים את ההזמנה
POST	/tables/table_bookings	אישור הזמנה	דורש מזהה table_lock תקף

ז. חיבור וצ'אט (אינטגרציה עם Agora)

תכונות "House Connect" מנצלות את Agora לתקשורת בזמן אמת, כפי שמעיד הפרמטר agora_id.

שיטה	נקודת קצה	תיאור	הערות
GET	/connect/checkins	לוח מודעות	filter[venue_id] כדי לראות מי נמצא בבית
POST	/connect/checkins	פרסום בלוח המודעות	Payload: status, venue_id
GET	/chat/timeslots	זמינות צ'אט	רשימה של זמני פתיחה עבור "House Connect"
POST	/chat/chat_tokens	קבלת טוקן צ'אט	מחזיר טוקן עבור אינטגרציה עם Stream/Agora
POST	/chat/rooms/{id}/room_accesses	הצטרפות לחדר	Payload כולל agora_id

ח. בקשות חברות

נקודות קצה בשימוש במהלך תהליך ההרשמה, כולל אינטגרציה עם Braintree לתשלומים.

שיטה	נקודת קצה	תיאור
GET	/applications	רשימת הבקשות של המשתמש
POST	/applications	הגשת בקשה חדשה
POST	/applications/{id}/attachments	העלאת תעודה/תמונה
GET	/products	רשימת מוצרים לחברות

ט. תוכן ועריכה

נקודות קצה לקריאה בלבד עבור תוכן האפליקציה, הערות הבית ודפים סטטיים.

שיטה	נקודת קצה	תיאור	מסננים מרכזיים
GET	/content/house_notes	תוכן עיתונאי	filter[venue_id], filter[content_category_id]
GET	/content/perks	הטבות לחברים	filter[region]
GET	/content/house_rules	כללי הבית	filter[venue_id]
GET	/content/house_tours	סיורי הבית	filter[venue_id]

י. שליטה במערכת

שיטה	נקודת קצה	תיאור
GET	/force_update	מחזיר 426 Upgrade Required אם גרסת האפליקציה תואמת לרשימה מיושנת, מכריח את המשתמשים לעדכן דרך חנות האפליקציות.

סיכום

ה-API של Soho House הוא יישום מתוחכם של תקני JSON:API, המארגן רשת מורכבת של מערכות POS ישנות (Simphony), טכנולוגיה מודרנית בזמן אמת (Agora) וניהול זהות גלובלית. עבור מפתחים, הוא משמש ככיתה אמן כיצד לעטוף מערכות אירוח ישנות ב-API REST מודרני וממוקד במובייל.

---

הבהרה: ניתוח זה מתבסס על תמונה של תיעוד הנגיש לציבור באוקטובר 2025.