# 카플랫 개발자 센터 > 카플랫에 등록된 차량·상품·예약·스케줄 데이터를 다루는 파트너용 REST API와, 카플랫이 고객사 서버로 보내는 콜백 이벤트를 안내합니다. ## 서버 - 테스트 서버: `https://test-api-partners.carplat.co.kr` - 운영 서버: `https://api-partners.carplat.co.kr` ## 핵심 규칙 - 고객사가 카플랫 API(`/developer/v1/...`)를 호출할 때는 `X-TURU-KEY: {API_KEY}` 헤더를 포함합니다. - 콜백 이벤트(`/events/...`)는 카플랫이 고객사 서버로 보내는 요청으로, 고객사 서버가 엔드포인트를 구현해 수신합니다. 콜백 요청에는 `X-TURU-KEY` 헤더가 없으므로 HTTPS와 카플랫 서버 IP 허용 목록으로 보호합니다. - 요청과 응답 본문은 JSON(`Content-Type: application/json`)입니다. - HTTPS, TLS 1.2 이상만 지원합니다. - 연동 개발과 검증은 테스트 서버에서 진행한 뒤 운영 서버로 전환합니다. - 필드 타입, 필수 여부, 길이 제한 같은 제약의 최종 기준은 OpenAPI 명세(https://developers.carplat.co.kr/openapi.json)입니다. ## 가이드 - [AI로 개발하기](https://developers.carplat.co.kr/guides/ai.md): ChatGPT, Claude, Cursor 같은 AI 도구에 카플랫 문서를 연결해 연동 코드를 작성하는 방법을 설명합니다. - [차량](https://developers.carplat.co.kr/guides/car.md): 카플랫에 차량을 등록하고 관리하는 방법을 설명합니다. - [상품](https://developers.carplat.co.kr/guides/product.md): 카플랫에 상품을 등록하고 관리하는 방법을 설명합니다. - [예약](https://developers.carplat.co.kr/guides/reservation.md): 카플랫에서 예약이 생성되고 예약 상태가 변경되는 과정을 설명합니다. - [스케줄](https://developers.carplat.co.kr/guides/schedule.md): 카플랫에서 차량 스케줄을 관리하고 예약과 연동하는 방법을 설명합니다. - [방화벽 및 보안 프로토콜](https://developers.carplat.co.kr/guides/security.md): 카플랫 API 연동 시 필요한 방화벽 설정과 보안 프로토콜을 설명합니다. - [요청 및 응답 형식](https://developers.carplat.co.kr/guides/req-res.md): 카플랫 API 요청 및 응답 형식을 설명합니다. - [콜백 이벤트](https://developers.carplat.co.kr/guides/callback-event.md): 카플랫 API 콜백 이벤트 종류와 처리 방법을 설명합니다. - [에러 코드](https://developers.carplat.co.kr/guides/error-code.md): 카플랫 API가 응답하는 에러 코드를 설명합니다. ## API 레퍼런스 - [API 레퍼런스 전체 (Markdown)](https://developers.carplat.co.kr/reference.md): 모든 엔드포인트의 파라미터, 요청·응답 필드, 예시 - [OpenAPI 명세 (JSON)](https://developers.carplat.co.kr/openapi.json): 코드 생성과 타입 정의에 쓸 수 있는 OpenAPI 3.0 원본 - [배차 취소](https://developers.carplat.co.kr/reference#put-developer-v1-reservation-id-dispatch-cancel): `PUT /developer/v1/reservation/{id}/dispatch/cancel` - [배차완료 전 차량 사진 일괄 등록](https://developers.carplat.co.kr/reference#post-developer-v1-reservation-id-dispatch-carImage): `POST /developer/v1/reservation/{id}/dispatch/carImage` - [배차 완료](https://developers.carplat.co.kr/reference#put-developer-v1-reservation-id-dispatch-complete): `PUT /developer/v1/reservation/{id}/dispatch/complete` - [배차완료 전 주차 사진 등록](https://developers.carplat.co.kr/reference#post-developer-v1-reservation-id-dispatch-parkingImage): `POST /developer/v1/reservation/{id}/dispatch/parkingImage` - [배차 출발](https://developers.carplat.co.kr/reference#put-developer-v1-reservation-id-dispatch-start): `PUT /developer/v1/reservation/{id}/dispatch/start` - [회수완료 전 차량 사진 일괄 등록](https://developers.carplat.co.kr/reference#post-developer-v1-reservation-id-recall-carImage): `POST /developer/v1/reservation/{id}/recall/carImage` - [회수 완료](https://developers.carplat.co.kr/reference#put-developer-v1-reservation-id-recall-complete): `PUT /developer/v1/reservation/{id}/recall/complete` - [스케줄 등록](https://developers.carplat.co.kr/reference#post-developer-v1-schedule): `POST /developer/v1/schedule` - [스케줄 수정](https://developers.carplat.co.kr/reference#put-developer-v1-schedule-id): `PUT /developer/v1/schedule/{id}` - [스케줄 삭제](https://developers.carplat.co.kr/reference#delete-developer-v1-schedule-id): `DELETE /developer/v1/schedule/{id}` - [예약 정보 등록 이벤트](https://developers.carplat.co.kr/reference#post-events-reservation): `POST /events/reservation` - [예약 정보 업데이트 이벤트](https://developers.carplat.co.kr/reference#put-events-reservation-id): `PUT /events/reservation/{id}` - [예약 차량 변경 이벤트](https://developers.carplat.co.kr/reference#put-events-reservation-id-car-change): `PUT /events/reservation/{id}/car-change` - [예약 반납 연장 이벤트](https://developers.carplat.co.kr/reference#put-events-reservation-id-extension): `PUT /events/reservation/{id}/extension` - [하이패스 결제 정보 전달](https://developers.carplat.co.kr/reference#post-events-hipass): `POST /events/hipass` ## Optional - [전체 문서](https://developers.carplat.co.kr/llms-full.txt): 모든 가이드와 API 레퍼런스를 한 파일로 합친 문서