सोहो हाउस एपीआई (अनौपचारिक तकनीकी गाइड 2025)
सोहो हाउस डिजिटल पारिस्थितिकी तंत्र में एक व्यापक तकनीकी गहराई। हम स्टेजिंग वातावरण, तृतीय-पक्ष एकीकरण (ओरेकल सिम्फनी, अगोरा, अल्गोलिया) और 'हाउस पे', रूम बुकिंग और सदस्य कनेक्शन के पीछे की आंतरिक लॉजिक का विश्लेषण करते हैं जैसा कि 2025 के सार्वजनिक एपीआई विनिर्देश में प्रकट होता है।
The Tech Insider
Author
The Tech Insider
सोहो हाउस एपीआई (अनौपचारिक तकनीकी गाइड 2025)
8 अक्टूबर 2025 को, सोहो हाउस डिजिटल पारिस्थितिकी तंत्र के लिए एक व्यापक पोस्टमैन संग्रह सार्वजनिक रूप से उपलब्ध कराया गया था docs.sohohousedigital.com पर। जबकि इसका उद्देश्य आंतरिक उपयोग के लिए था, इसकी उपलब्धता एक वैश्विक लक्जरी आतिथ्य ब्रांड के डिजिटल सदस्यता अनुभव को कैसे आर्किटेक्ट करता है, इस पर एक आकर्षक खिड़की प्रदान करता है।
यह गाइड तकनीकी स्टैक, स्टेजिंग वातावरण, और तृतीय-पक्ष एकीकरण (ओरेकल सिम्फनी, अगोरा, 3C) का विश्लेषण करता है जो सब कुछ संचालित करता है, कमरे की बुकिंग से लेकर "हाउस पे" बिल-स्प्लिटिंग फीचर तक। इसमें विनिर्देश के भीतर पाए जाने वाले एंडपॉइंट्स, पैरामीटर और कॉन्फ़िगरेशन विवरण का एक पूरा संदर्भ शामिल है।
अस्वीकृति: हम सोहो हाउस एंड कंपनी से संबद्ध नहीं हैं। यह विश्लेषण पूरी तरह से सार्वजनिक रूप से उपलब्ध दस्तावेज़ीकरण पर आधारित है और शैक्षिक और अंतःक्रियाशीलता अनुसंधान उद्देश्यों के लिए है।
1. अवसंरचना और वातावरण
एपीआई विनिर्देश उत्पादन और स्टेजिंग वातावरण के बीच स्पष्ट विभाजन प्रकट करता है, जो माइक्रोसर्विस-शैली रूटिंग आर्किटेक्चर का उपयोग करता है। यह "द नेड" और "सोहो वर्क्स" जैसे विशिष्ट उप-ब्रांडों को भी उजागर करता है जो अलग पहचान प्रदाताओं पर काम कर रहे हैं।
होस्टनेम और सेवाएँ
- उत्पादन एपीआई:
https://api.production.sohohousedigital.com - स्टेजिंग एपीआई:
https://api.staging.sohohousedigital.com - द नेड (स्टेजिंग):
https://api-ned.staging.sohohousedigital.com - संस्करण नियंत्रण सेवा:
https://vcs-master.staging.sohohousedigital.com(Used forforce_updatechecks) - अल्गोलिया सर्च:
https://MRH59RRZDT-dsn.algolia.net(App ID:MRH59RRZDT)
पहचान प्रदाता
प्रमाणीकरण विभिन्न ब्रांडों में संघीय है:
- सोहो हाउस:
identity.houseseven.com - द नेड:
identity.thened.com - सोहो वर्क्स:
identity.sohohouse.com
2. प्रमाणीकरण और "सार्वजनिक रहस्य"
एपीआई मानक ओथ2 का उपयोग करता है। चूंकि मोबाइल ऐप "सार्वजनिक क्लाइंट" हैं, client_id और client_secret सीधे एप्लिकेशन कोड में एम्बेडेड होते हैं। पोस्टमैन संग्रह स्पष्ट रूप से इन क्रेडेंशियल्स को उजागर करता है, जिससे हमें प्रमाणीकरण प्रवाह को समझने की अनुमति मिलती है।
विशेषज्ञों द्वारा पाए गए क्रेडेंशियल्स:
client_id: "200140c7**************************************3b96fef0"
client_secret: "7362f55c4**************************************2e29018a6"
गेटवे हेडर
एक बार जब उपयोगकर्ता /oauth/token के माध्यम से लॉग इन करता है, तो एपीआई गेटवे अपस्ट्रीम अनुरोधों में विशिष्ट हेडर इंजेक्ट करता है। यह प्रकट करता है कि सोहो हाउस मल्टी-वेनी अनुमतियों का प्रबंधन कैसे करता है बिना हर अनुरोध पर डेटाबेस को क्वेरी किए:
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. एंडपॉइंट संदर्भ और कॉन्फ़िगरेशन
ए. प्रमाणीकरण और पहचान
मानक ओथ2 प्रवाह का उपयोग सभी अन्य एंडपॉइंट्स के लिए आवश्यक बियरर टोकन उत्पन्न करने के लिए किया जाता है।
| विधि | एंडपॉइंट | विवरण | पैरामीटर / पेलोड |
|---|---|---|---|
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 |
विरासती खाता जानकारी | बुनियादी आईडी और स्थानीय स्थल लौटाता है |
बी. खाते, प्रोफाइल और सदस्यताएँ
उपयोगकर्ता की डिजिटल पहचान प्रबंधित करने के लिए एंडपॉइंट्स। 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 |
कार्ड द्वारा लुकअप | एक भौतिक कार्ड नंबर को एक वैश्विक आईडी में हल करें |
सी. कार्यक्रम और सिनेमा
हाउस कार्यक्रमों की सूची बनाने और बुकिंग के लिए व्यापक एंडपॉइंट्स। लॉजिक में "लॉटरी" (उच्च मांग वाले कार्यक्रम) के लिए विशिष्ट हैंडलिंग शामिल है।
| विधि | एंडपॉइंट | विवरण | प्रमुख फ़िल्टर / पैरामीटर |
|---|---|---|---|
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 |
कार्यक्रम बुक करें | पेलोड: guests एरे, event आईडी, payment_card आईडी |
DELETE |
/events/bookings/{id} |
बुकिंग रद्द करें | एन/ए |
डी. कमरे (होटल बुकिंग)
कमरे एंडपॉइंट्स कमरे के प्रकार और दर योजनाओं के लिए आंतरिक कोड प्रकट करते हैं। 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 |
बुकिंग बनाएं | पेलोड: address, dates, availability_rate आईडी |
PATCH |
/rooms/room_bookings/{id} |
बुकिंग संशोधित करें | तिथियों या अतिथि की संख्या को बदलें |
ई. हाउस पे (चेक और सिम्फनी एकीकरण)
यह अनुभाग ओरेकल माइक्रोस सिम्फनी के साथ एक तंग एकीकरण प्रकट करता है। एपीआई सदस्यों को सीधे रेस्तरां के बिल का भुगतान करने की अनुमति देता है। इसमें एक विशिष्ट "वॉकआउट" एंडपॉइंट शामिल है, जो संभवतः एक सदस्य की फ़ाइल के खिलाफ चेक को स्वचालित रूप से बंद करने के लिए उपयोग किया जाता है।
| विधि | एंडपॉइंट | विवरण | अंदरूनी नोट्स |
|---|---|---|---|
GET |
/checks/public/checks |
खुले चेक की सूची | filter['status']=open |
GET |
/checks/public/checks/{id} |
चेक विवरण प्राप्त करें | आइटम, कर, सेवा शुल्क लौटाता है |
POST |
/checks/public/payments |
चेक का भुगतान करें | पेलोड: check_id, amount_cents, card_id, tip_amount_cents |
POST |
/checks/public/payments/walkout |
वॉकआउट भुगतान | चेक बंद करने के लिए simphony_manager_id का उपयोग करता है |
POST |
/checks/public/checks/{id}/discount |
छूट लागू करें | पेलोड: discount_id (जैसे U27 दरें) |
POST |
/checks/public/checks/{id}/email |
रसीद ईमेल करें | पीडीएफ रसीद ईमेल को ट्रिगर करता है |
GET |
/payments/cards |
कार्डों की सूची | filter[venue] (आमतौर पर हार्डकोडेड 'GRS') |
एफ. टेबल (रेस्तरां बुकिंग)
एपीआई चेकआउट प्रक्रिया के दौरान डबल-बुकिंग को रोकने के लिए "लॉक" तंत्र का उपयोग करता है।
| विधि | एंडपॉइंट | विवरण | अंदरूनी नोट्स |
|---|---|---|---|
GET |
/tables/availabilities |
स्लॉट खोजें | filter[restaurant_id] (जैसे, SH_SIXTH_FLOOR_RESTAURANTS) |
POST |
/tables/locks |
तालिका लॉक करें | उपयोगकर्ता बुकिंग पूरी करते समय x मिनट के लिए एक स्लॉट लॉक करता है |
POST |
/tables/table_bookings |
बुकिंग की पुष्टि करें | मान्य table_lock आईडी की आवश्यकता है |
जी. कनेक्ट और चैट (अगोरा एकीकरण)
"हाउस कनेक्ट" सुविधाएँ वास्तविक समय संचार के लिए अगोरा का उपयोग करती हैं, जो agora_id पैरामीटर से प्रमाणित होती है।
| विधि | एंडपॉइंट | विवरण | नोट्स |
|---|---|---|---|
GET |
/connect/checkins |
नोटिसबोर्ड | filter[venue_id] यह देखने के लिए कि कौन से हाउस में है |
POST |
/connect/checkins |
नोटिसबोर्ड पर पोस्ट करें | पेलोड: status, venue_id |
GET |
/chat/timeslots |
चैट उपलब्धता | "हाउस कनेक्ट" के लिए खुले स्लॉट की सूची |
POST |
/chat/chat_tokens |
चैट टोकन प्राप्त करें | स्ट्रीम/अगोरा एकीकरण के लिए टोकन लौटाता है |
POST |
/chat/rooms/{id}/room_accesses |
कमरे में शामिल हों | पेलोड में agora_id शामिल है |
एच. सदस्यता आवेदन
साइनअप प्रवाह के दौरान उपयोग किए जाने वाले एंडपॉइंट्स, जिसमें भुगतान के लिए ब्रेंट्री एकीकरण शामिल है।
| विधि | एंडपॉइंट | विवरण |
|---|---|---|
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 अपग्रेड आवश्यक लौटाता है, उपयोगकर्ताओं को ऐप स्टोर के माध्यम से अपडेट करने के लिए मजबूर करता है। |
निष्कर्ष
सोहो हाउस एपीआई JSON:API मानकों का एक परिष्कृत कार्यान्वयन है, जो विरासती पीओएस सिस्टम (सिम्फनी), आधुनिक वास्तविक समय तकनीक (अगोरा), और वैश्विक पहचान प्रबंधन के एक जटिल वेब का आयोजन करता है। डेवलपर्स के लिए, यह एक मास्टरक्लास के रूप में कार्य करता है कि कैसे विरासती आतिथ्य प्रणालियों को एक आधुनिक, मोबाइल-प्रथम REST एपीआई में लपेटा जाए।
अस्वीकृति: यह विश्लेषण अक्टूबर 2025 में सार्वजनिक रूप से उपलब्ध दस्तावेज़ीकरण के एक स्नैपशॉट पर आधारित है।
संदर्भ और उद्धरण
संपादकीय खुलासा
यह लेख एक स्वतंत्र प्रकाशन है। हम सोहो हाउस और कंपनी से संबद्ध नहीं हैं। जानकारी सार्वजनिक स्रोतों और टिप्पणी और आलोचना के लिए निष्पक्ष उपयोग सिद्धांतों पर आधारित है। कोई समर्थन निहित नहीं है।
