홈페이지 연동
이미 있는 회사 홈에 예약, 주문, 회원 데이터만 붙이는 작업입니다. 홈 디자인은 그대로 두고, 앱과 관리자가 같은 DB나 API를 보도록 맞춥니다. WordPress 쇼핑몰, Cafe24, 외주로 만든 PHP 사이트처럼 플랫폼마다 연결 방법이 달라서, 먼저 구조를 보고 범위를 정합니다.
회원은 홈에서 가입한 계정으로 앱에도 로그인할 수 있게 SSO나 토큰 연동을 넣습니다. 홈 DB를 직접 읽을 수 있으면 API 레이어를 얹고, 플랫폼 API만 열려 있으면 그쪽 문서에 맞춰 sync 스크립트를 짭니다.
한 번에 다 붙이기 어렵으면 1단계는 조회만, 2단계는 예약 쓰기까지처럼 나눠 진행할 수 있습니다. 스테이징 서버에서 홈과 앱이 같은 주문 번호, 같은 재고 숫자를 보는지 확인한 뒤 본 서버에 올립니다.
기업 소개용 홈에 회원 전용 앱을 붙이거나, 랜딩 페이지와 별도 앱을 같은 로그인으로 묶는 경우도 같은 방식으로 봅니다. 연동 후에도 홈 쪽 업데이트 때 API가 깨지지 않게 버전과 롤백 방법을 문서로 남깁니다.
이런 경우에 맞아요
- WordPress + WooCommerce 쇼핑몰에 주문, 재고를 앱과 맞춰야 할 때
- Cafe24 몰 회원, 주문 API로 앱 로그인과 배송 조회를 붙이는 경우
- 외주 PHP로 만든 자체 사이트 DB에 REST API를 얹어 앱과 sync하는 경우
- 기업 소개 홈은 유지하고, 회원 포털이나 예약 앱만 따로 추가하는 경우
- 마케팅 랜딩 페이지와 별도 앱을 같은 SSO, 회원 DB로 묶으려 할 때
포함 기능
- REST API 설계, Swagger 문서
- 홈-앱 양방향 데이터 sync
- 회원 SSO, OAuth 연동
- JWT, API 토큰 발급
- 예약, 주문 조회 API
- 재고, 슬롯 실시간 sync
- 웹훅 수신, 발행
- 배치 동기화 (야간)
- 관리자 통합 대시보드
- 스테이징 연동 테스트
- API 버전, 롤백 계획
- 단계별 오픈 (조회, 예약)
진행 순서
- 현황 파악 홈 호스팅, DB, CMS, 사용 중인 플러그인과 API 문서를 확인합니다.
- API 범위 확정 어떤 데이터를 어디서 읽고 쓸지, SSO 방식까지 목록으로 만듭니다.
- 연동 개발 스테이징에서 홈과 앱이 같은 회원, 주문, 재고를 보는지 검증합니다.
- 본 서버 반영 트래픽 적은 시간대에 올리고, sync 실패 시 롤백 방법을 준비합니다.
플랫폼별 연동 예
기존 홈
WordPress 쇼핑몰은 WooCommerce 주문 테이블을 API로 노출하거나, 플러그인 훅으로 재고 변경을 웹훅으로 보냅니다. Cafe24는 제공 API로 회원 조회, 주문 상태 sync를 맞추고, 자체 PHP 사이트는 MySQL 위에 REST 레이어를 얹는 경우가 많습니다.
기업 소개 홈은 HTML 그대로 두고, 회원 메뉴만 앱 딥링크로 연결합니다. 랜딩 페이지는 가입 폼 제출 시 같은 SSO 토큰을 앱에 넘겨, 홈과 앱에서 한 계정으로 보이게 합니다.
앱, API, 관리자
앱은 GET /orders, POST /book 같은 엔드포인트로 홈 DB와 같은 숫자를 봅니다. 로그인은 JWT를 발급해 홈 세션과 맞추거나, 카카오 SSO를 양쪽에 공통으로 붙입니다.
관리자 대시보드에서는 홈, 앱, 키오스크 채널 주문을 한 목록으로 모읍니다. sync 큐가 쌓이면 재시도하고, API 버전을 올릴 때는 구버전도 잠시 유지해 홈 플러그인 업데이트와 맞춥니다.
자주 묻는 것
홈 디자인도 바꿔야 하나요?
아니요. 연동만 필요하면 홈 UI는 건드리지 않고 API, SSO만 붙이는 경우가 많습니다. 버튼 하나로 앱으로 넘기는 정도만 추가할 수도 있습니다.
WordPress나 Cafe24도 같은 방식인가요?
목표는 같지만 연결 지점이 다릅니다. WooCommerce 훅, Cafe24 Open API, 자체 PHP REST 중 어디가 열려 있는지 먼저 보고 방법을 고릅니다.
외주로 만든 홈도 가능한가요?
됩니다. FTP, DB 접근, 기존 API 문서만 있어도 검토할 수 있습니다. 코드가 없으면 DB 스키마만으로도 범위를 잡을 수 있습니다.
홈과 앱 회원이 따로면 SSO로 묶나요?
홈 계정을 기준으로 JWT나 OAuth 브릿지를 두면, 앱에서 같은 이메일, 전화번호로 로그인할 수 있습니다. 카카오 로그인을 양쪽에 공통으로 쓰는 방법도 있습니다.
연동 후 유지보수는?
홈 CMS 업데이트, 플러그인 교체 때 API가 깨지지 않게 버전을 맞춰 두고, sync 오류 로그를 봅니다. 필요하면 유지, 운영 계약을 따로 잡습니다.