Soho House API (Ανεπίσημος Τεχνικός Οδηγός 2025)

Στις 8 Οκτωβρίου 2025, μια ολοκληρωμένη συλλογή Postman για το ψηφιακό οικοσύστημα του Soho House έγινε δημόσια διαθέσιμη στο docs.sohohousedigital.com. Ενώ προορίζεται για εσωτερική χρήση, η διαθεσιμότητά της προσφέρει ένα συναρπαστικό παράθυρο στο πώς μια παγκόσμια πολυτελής μάρκα φιλοξενίας σχεδιάζει την ψηφιακή εμπειρία μέλους της.

Αυτός ο οδηγός αναλύει την τεχνική στοίβα, τα περιβάλλοντα staging και τις τρίτες καταθέσεις (Oracle Simphony, Agora, 3C) που τροφοδοτούν τα πάντα, από τις κρατήσεις δωματίων μέχρι τη λειτουργία διαχωρισμού λογαριασμού "House Pay". Περιλαμβάνει μια πλήρη αναφορά των endpoints, παραμέτρων και λεπτομερειών διαμόρφωσης που βρίσκονται μέσα στην προδιαγραφή.

Αποποίηση ευθύνης: Δεν είμαστε συνδεδεμένοι με το Soho House & Co. Αυτή η ανάλυση βασίζεται αυστηρά σε δημόσια προσβάσιμη τεκμηρίωση και προορίζεται για εκπαιδευτικούς και ερευνητικούς σκοπούς διαλειτουργικότητας.

1. Υποδομή & Περιβάλλοντα

Η προδιαγραφή API αποκαλύπτει μια σαφή διάκριση μεταξύ παραγωγής και περιβαλλόντων staging, χρησιμοποιώντας μια αρχιτεκτονική δρομολόγησης τύπου μικροϋπηρεσιών. Επίσης, εκθέτει συγκεκριμένες υπο-μάρκες όπως "The Ned" και "Soho Works" που λειτουργούν σε διακριτούς παρόχους ταυτοτήτων.

Ονόματα υποδοχών & Υπηρεσίες

• API Παραγωγής: https://api.production.sohohousedigital.com
• API Staging: https://api.staging.sohohousedigital.com
• The Ned (Staging): https://api-ned.staging.sohohousedigital.com
• Υπηρεσία Ελέγχου Έκδοσης: https://vcs-master.staging.sohohousedigital.com (Χρησιμοποιείται για ελέγχους force_update)
• Αναζήτηση Algolia: https://MRH59RRZDT-dsn.algolia.net (App ID: 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 (Shoreditch), BH (Babington), GRS (Greek Street)).

3. Αναφορά Endpoints & Διαμόρφωση

A. Αυθεντικοποίηση & Ταυτότητα

Πρότυπες ροές OAuth2 που χρησιμοποιούνται για τη δημιουργία του Bearer token που απαιτείται για όλα τα άλλα endpoints.

Μέθοδος	Endpoint	Περιγραφή	Παράμετροι / 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 και τοπικό χώρο

B. Λογαριασμοί, Προφίλ & Συνδρομές

Endpoints για τη διαχείριση της ψηφιακής ταυτότητας του χρήστη. Η παράμετρος include υποδηλώνει μια δομή σχεσιακής βάσης δεδομένων στο backend.

Μέθοδος	Endpoint	Περιγραφή	Διαμόρφωση / Σημειώσεις
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

C. Εκδηλώσεις & Σινεμά

Ολοκληρωμένα endpoints για την καταχώρηση και κράτηση εκδηλώσεων του σπιτιού. Η λογική περιλαμβάνει συγκεκριμένη διαχείριση για "Λαχνούς" (εκδηλώσεις υψηλής ζήτησης).

Μέθοδος	Endpoint	Περιγραφή	Κύριες Φίλτρα / Παράμετροι
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 array, event ID, payment_card ID
DELETE	/events/bookings/{id}	Ακύρωση Κράτησης	N/A

D. Δωμάτια (Κράτηση Ξενοδοχείου)

Τα endpoints rooms αποκαλύπτουν εσωτερικούς κωδικούς για τύπους δωματίων και σχέδια τιμολόγησης. Το endpoint days είναι ιδιαίτερα ενδιαφέρον καθώς αποκαλύπτει το ημερολόγιο τιμολόγησης.

Μέθοδος	Endpoint	Περιγραφή	Σημειώσεις Insider / Παράμετροι
GET	/rooms/hotels	Λίστα Ξενοδοχείων	Επιστρέφει URLs κρατήσεων και πληροφορίες φόρου
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 ID
PATCH	/rooms/room_bookings/{id}	Τροποποίηση Κράτησης	Αλλαγή ημερομηνιών ή αριθμού επισκεπτών

E. House Pay (Έλεγχοι & Ενσωμάτωση Simphony)

Αυτή η ενότητα αποκαλύπτει μια στενή ενσωμάτωση με Oracle Micros Simphony. Το API επιτρέπει στα μέλη να πληρώνουν απευθείας τους λογαριασμούς εστιατορίου. Περιλαμβάνει μια συγκεκριμένη λειτουργία "Walkout", πιθανώς χρησιμοποιούμενη για να κλείνει αυτόματα τους λογαριασμούς σε σχέση με το αρχείο ενός μέλους.

Μέθοδος	Endpoint	Περιγραφή	Σημειώσεις Insider
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 rates)
POST	/checks/public/checks/{id}/email	Αποστολή Απόδειξης	Ενεργοποιεί την αποστολή PDF απόδειξης
GET	/payments/cards	Λίστα Καρτών	filter[venue] (συνήθως σκληρά κωδικοποιημένο 'GRS')

F. Τραπέζια (Κράτηση Εστιατορίου)

Το API χρησιμοποιεί έναν μηχανισμό "Κλειδώματος" για να αποτρέψει την διπλή κράτηση κατά τη διαδικασία ολοκλήρωσης.

Μέθοδος	Endpoint	Περιγραφή	Σημειώσεις Insider
GET	/tables/availabilities	Αναζήτηση Θέσεων	filter[restaurant_id] (π.χ., SH_SIXTH_FLOOR_RESTAURANTS)
POST	/tables/locks	Κλείδωμα Τραπέζι	Κλειδώνει μια θέση για x λεπτά ενώ ο χρήστης ολοκληρώνει την κράτηση
POST	/tables/table_bookings	Επιβεβαίωση Κράτησης	Απαιτεί έγκυρο table_lock ID

G. Σύνδεση & Συνομιλία (Ενσωμάτωση Agora)

Οι λειτουργίες "House Connect" χρησιμοποιούν Agora για πραγματική επικοινωνία, όπως αποδεικνύεται από την παράμετρο agora_id.

Μέθοδος	Endpoint	Περιγραφή	Σημειώσεις
GET	/connect/checkins	Πίνακας Ανακοινώσεων	filter[venue_id] για να δείτε ποιος είναι σε ένα σπίτι
POST	/connect/checkins	Δημοσίευση στον Πίνακα Ανακοινώσεων	Payload: status, venue_id
GET	/chat/timeslots	Διαθεσιμότητα Συνομιλίας	Λίστα ανοιχτών θέσεων για "House Connect"
POST	/chat/chat_tokens	Λήψη Token Συνομιλίας	Επιστρέφει token για ενσωμάτωση Stream/Agora
POST	/chat/rooms/{id}/room_accesses	Είσοδος σε Δωμάτιο	Το Payload περιλαμβάνει agora_id

H. Αιτήσεις Συνδρομής

Endpoints που χρησιμοποιούνται κατά τη διαδικασία εγγραφής, συμπεριλαμβανομένης της ενσωμάτωσης Braintree για πληρωμές.

Μέθοδος	Endpoint	Περιγραφή
GET	/applications	Λίστα αιτήσεων του χρήστη
POST	/applications	Υποβολή νέας αίτησης
POST	/applications/{id}/attachments	Ανέβασμα Ταυτότητας/Φωτογραφίας
GET	/products	Λίστα Προϊόντων Συνδρομής

I. Περιεχόμενο & Συντακτική

Endpoints μόνο για ανάγνωση για περιεχόμενο εφαρμογής, σημειώσεις σπιτιού και στατικές σελίδες.

Μέθοδος	Endpoint	Περιγραφή	Κύρια Φίλτρα
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]

J. Έλεγχος Συστήματος

Μέθοδος	Endpoint	Περιγραφή
GET	/force_update	Επιστρέφει 426 Upgrade Required αν η έκδοση της εφαρμογής ταιριάζει με μια λίστα που έχει αποσυρθεί, αναγκάζοντας τους χρήστες να ενημερώσουν μέσω του App Store.

Συμπέρασμα

Το Soho House API είναι μια προηγμένη εφαρμογή των προτύπων JSON:API, οργανώνοντας ένα πολύπλοκο δίκτυο κληρονομικών συστημάτων POS (Simphony), σύγχρονης τεχνολογίας σε πραγματικό χρόνο (Agora) και παγκόσμιας διαχείρισης ταυτότητας. Για τους προγραμματιστές, χρησιμεύει ως μάστερ σεμινάριο για το πώς να τυλίγουν τα κληρονομικά συστήματα φιλοξενίας σε μια σύγχρονη, κινητή πρώτης REST API.

---

Αποποίηση ευθύνης: Αυτή η ανάλυση βασίζεται σε μια στιγμιότυπο της τεκμηρίωσης που είναι διαθέσιμη δημόσια τον Οκτώβριο του 2025.