개발자 센터
Carplat API Guide

렌트카 서비스를 빠르게 연결하는 실전형 API 가이드

차량, 상품, 예약, 스케줄, 콜백까지 B2B 개발자가 실제 연동에서 부딪히는 순서대로 카플랫 API의 핵심 흐름을 안내합니다.

예약 생성

POST /reservations

200 OK

curl --request POST

https://api.carplat.co.kr/reservations

Authorization: Bearer YOUR_API_KEY

{
  "reservationId": 392184,
  "status": "CONFIRMED",
  "carNumber": "123하4567",
  "pickupAt": "2026-06-01T10:00:00+09:00",
  "returnAt": "2026-06-03T18:00:00+09:00"
}

권장 연동 순서

처음 붙는 팀도 운영 영향도를 낮추도록 보안, 데이터 모델, 예약, 콜백 순서로 정리했습니다.

연동 체크포인트

  • API 키는 서버 환경 변수로만 보관합니다.
  • 상품과 스케줄 동기화는 예약 생성 전에 완료합니다.
  • 예약 상태 변경은 콜백 이벤트까지 함께 검증합니다.
  • 에러 코드는 사용자 메시지와 운영 알림으로 분리합니다.

운영 연동 전에 보안부터 확인하세요

방화벽, 인증 헤더, 콜백 수신 URL을 먼저 확정하면 이후 예약 API와 웹훅 검증이 훨씬 단순해집니다.

보안 가이드