택마니 API 가이드
택배사 목록, 송장 배송조회와 API 이용량을 서버에서 연동하는 공개 개발자 가이드입니다.
택마니 API는 택배사 목록 조회, 배송 상태 조회, API 키 이용량 확인을 제공합니다. 이 가이드는 실제 요청을 보내는 데 필요한 인증, 요청 형식, 응답 계약과 오류 코드를 설명합니다.
시작하기
API 키를 발급하고 첫 배송조회 요청을 준비합니다.
인증
endpoint별 API 키 전달 위치와 보안 수칙을 확인합니다.
API
현재 제공하는 네 가지 operation의 계약을 확인합니다.
Cafe24 앱과 다른 서비스인가요?
이 가이드는 택배 송장 조회 OpenAPI의 문서입니다. 택배사 코드와 송장번호로 배송 결과를 조회하며 Cafe24 주문 상태를 자동 변경하지 않습니다. Cafe24 자동 배송완료가 필요하면 택마니 홈의 Cafe24 앱을 확인하세요. 문서는 로그인 없이 읽을 수 있고 실제 API 호출에는 OpenAPI 이용권에 연결된 API 키가 필요합니다.
제공 API
| Method | Path | 설명 |
|---|---|---|
GET | /api/v1/companylist | 사용할 수 있는 택배사 목록 |
GET | /api/v1/trackingInfo | 배송조회 |
POST | /api/v1/trackingInfo | GET과 같은 배송조회 계약 |
GET | /api/v1/key/usage | 이용권 사용량과 기간 |
브라우저에서 API를 실행하는 Try It 기능은 제공하지 않습니다. 비밀 API 키가 문서 화면이나 browser
storage에 남지 않도록 서버 또는 안전한 개발 환경에서 cURL 예제를 실행하세요.