카플랫 개발자 센터
카플랫 API로 고객사 시스템에서 배차·회수와 차량 스케줄을 처리하고, 예약 변경을 콜백 이벤트로 받을 수 있습니다.
API 구성
고객사가 카플랫을 호출하는 REST API와, 카플랫이 고객사 서버로 보내는 콜백 이벤트로 구성됩니다.
REST API
고객사 → 카플랫/developer/v1/- –배차 출발·완료·취소
- –회수 완료
- –배차·회수 차량 사진, 주차 사진 등록
- –외부 스케줄 등록·수정·삭제
콜백 이벤트
카플랫 → 고객사/events/- –예약 등록·업데이트
- –예약 차량 변경
- –예약 반납 연장
- –하이패스 통행 정보
차량과 상품의 등록·수정·조회는 API로 제공하지 않으며 카플랫 웹사이트에서 관리합니다.
빠른 시작
- 1
API 키 발급
카플랫 API 연동 관리에서 API 키를 신청합니다. 발급받은 키는 모든 REST API 요청의
X-TURU-KEY헤더에 담아 보내며, 서버 환경 변수처럼 외부에 노출되지 않는 곳에 보관합니다. - 2
테스트 서버에서 호출
- 3
콜백 이벤트 수신 준비
API 연동 관리의 상세정보에서 콜백 URL과 받을 이벤트를 설정하고, 이벤트별 엔드포인트를 고객사 서버에 구현합니다. 카플랫 서버 IP는 방화벽에서 허용해야 합니다. 자세한 내용은 콜백 이벤트와 방화벽 및 보안 프로토콜을 참고하세요.
- 4
운영 서버로 전환
검증을 마치면 Base URL을 운영 서버 주소로 바꿉니다.
- 테스트
- https://test-api-partners.carplat.co.kr
- 운영
- https://api-partners.carplat.co.kr
AI로 개발하기
AI 도구에 llms.txt 주소를 알려주면 최신 문서와 API 명세를 기준으로 연동 코드를 작성하도록 요청할 수 있습니다.
text
Loading...