미어캣 API 센터
방문자 관리 API
Base URL
개발: https://bridge-dev.7meerkat.com
운영: https://bridge.7meerkat.com
Authorization
모든 API 요청에는 Authorization 헤더가 필요합니다.Authorization: Bearer {your-access-token}
공통 안내
1. 응답 코드 확인
- API 요청 후 반드시 응답 코드가
200또는201인지 확인해야 합니다. - 200/201이 아닌 경우 데이터 재전송 필요 (동기화 보장)
2. 인증 규칙
날짜 형식
- 형식:
YYYY-MM-DD startDate: 오늘 또는 이후 날짜만 가능endDate: startDate와 최대 7일 간격, 오늘부터 90일 이내
세대
dong,ho: 해당 주차장에 등록된 세대 정보만 가능
차량
carNumber: 기간 중복 등록 불가
3. ID 관리
- 예약 등록 시 반환되는
id는 취소 시 필수 - 응답 ID는 큰 숫자(bigint)이며, JSON 응답에서 문자열로 변환되어 반환됩니다
4. 재시도 로직
- 일시적 서버 오류 (
5xx) 발생 시 재시도 권장 - 비즈니스 로직 오류 (
4xx)는 재시도하지 않음
1/2.
POST
/v1/visitors방문 예정 차량의 주차 예약
2/2.
DELETE
/v1/visitors/:id등록된 예약 취소(이용 종료)