개발자

클럽과 인증 파트너를 위한 공개 REST API예요. 범위가 제한된 읽기, API를 통한 예약, HMAC로 서명된 웹훅을 제공해요.

인증

각 키는 클럽 패널의 설정 → 개발자에서 생성되며, Bearer 헤더로 전달돼요.

curl -H "Authorization: Bearer mp_…" \
  https://api.meetandplay.mx/api/v1/clubs/{clubId}/bookings

전체 키는 한 번만 표시돼요. 안전한 곳에 보관하세요.

각 키는 생성 시 부여된 범위를 가지고 있으며, 필요한 범위가 없는 요청은 거부돼요.

GET/clubs/{clubId}/courts
클럽의 코트 목록이에요.
GET/clubs/{clubId}/availability
코트별 예약된 시간대예요, 최대 14일.
GET/clubs/{clubId}/bookings
클럽의 예약 목록이에요, 최신순이에요.
GET/clubs/{clubId}/customers
클럽의 고객 명단이에요 — 개인정보라 별도 범위가 필요해요.
POST/clubs/{clubId}/bookings
클럽 데스크와 동일하게 예약을 생성해요.
POST/clubs/{clubId}/bookings/{bookingId}/cancel
예약을 취소해요. 클럽 정책에 따라 결제를 환불하거나 무효화해요.

예약 생성·확정·취소, 결제 성공, 경기 정원 마감 등의 이벤트를 자체 URL에서 HMAC-SHA256으로 서명되어 받아요. 전송이 실패하면 점진적으로 재시도하고, 여러 번 실패하면 실패 대기열로 이동해요. 클럽 패널에서 다시 전송할 수 있어요.

각 키는 분당 요청 수 제한이 있어요. 429 응답은 제한에 도달했다는 뜻이니 속도를 늦추고 다시 시도하세요.

인증 파트너는 클럽 패널에서 한 번의 클릭으로 연결돼요 — 키를 손으로 복사할 필요가 없어요.

클럽 패널에 로그인해서 설정 → 개발자에서 첫 키를 생성하세요.