개발자 센터

카플랫 개발자 센터

카플랫 API로 고객사 시스템에서 배차·회수와 차량 스케줄을 처리하고, 예약 변경을 콜백 이벤트로 받을 수 있습니다.

API 구성

고객사가 카플랫을 호출하는 REST API와, 카플랫이 고객사 서버로 보내는 콜백 이벤트로 구성됩니다.

차량과 상품의 등록·수정·조회는 API로 제공하지 않으며 카플랫 웹사이트에서 관리합니다.

빠른 시작

  1. 1

    API 키 발급

    카플랫 API 연동 관리에서 API 키를 신청합니다. 발급받은 키는 모든 REST API 요청의 X-TURU-KEY 헤더에 담아 보내며, 서버 환경 변수처럼 외부에 노출되지 않는 곳에 보관합니다.

  2. 2

    테스트 서버에서 호출

    연동 개발과 검증은 테스트 서버에서 진행합니다. 예약을 배차출발 상태로 바꾸는 요청은 다음과 같습니다.

    bash

    Loading...

    성공하면 HTTP 200과 함께 다음 응답을 받습니다.

    json

    Loading...

    요청·응답 형식은 요청 및 응답, 에러별 처리 방법은 에러 코드를 참고하세요.

  3. 3

    콜백 이벤트 수신 준비

    API 연동 관리의 상세정보에서 콜백 URL과 받을 이벤트를 설정하고, 이벤트별 엔드포인트를 고객사 서버에 구현합니다. 카플랫 서버 IP는 방화벽에서 허용해야 합니다. 자세한 내용은 콜백 이벤트와 방화벽 및 보안 프로토콜을 참고하세요.

  4. 4

    운영 서버로 전환

    검증을 마치면 Base URL을 운영 서버 주소로 바꿉니다.

    테스트
    https://test-api-partners.carplat.co.kr
    운영
    https://api-partners.carplat.co.kr

AI로 개발하기

AI 도구에 llms.txt 주소를 알려주면 최신 문서와 API 명세를 기준으로 연동 코드를 작성하도록 요청할 수 있습니다.

사용 방법 보기
text

Loading...

문서