시작하기
무료 이용권과 API 키를 발급하고 첫 요청을 준비합니다.
1. API 키 발급
가입·로그인한 뒤 OpenAPI Console의 이용권 화면에서 무료 이용권을 발급합니다. 이용권과 연결된 tmk_ prefix의
API 키 원문은 발급 직후 한 번만 표시됩니다. 분실한 원문은 복구하거나 다시 표시할 수 없습니다.
API 키를 비밀로 관리하세요
소스 코드, Git, URL, browser storage와 로그에 API 키를 저장하지 마세요. 서버의 secret manager나 환경 변수로 관리하는 것을 권장합니다.
2. 환경 변수 준비
택마니 운영 API 주소와 발급한 키를 서버 환경 변수에 넣습니다. Cafe24 앱 연결 없이 사용할 수 있습니다.
export TAEKMANI_BASE_URL="https://taekmani.almani-center.com"
export TAEKMANI_API_KEY="tmk_REPLACE_WITH_YOUR_KEY"3. 택배사 목록 확인
curl --get "$TAEKMANI_BASE_URL/api/v1/companylist" \
--data-urlencode "t_key=$TAEKMANI_API_KEY" \
--header "Accept: application/json"응답의 Company[].Code를 배송조회 요청의 t_code로 사용합니다. 현재 활성화된 택배사만 반환되므로
code를 application에 고정하기보다 주기적으로 목록을 갱신하세요.
4. 배송조회
curl --get "$TAEKMANI_BASE_URL/api/v1/trackingInfo" \
--data-urlencode "t_key=$TAEKMANI_API_KEY" \
--data-urlencode "t_code=04" \
--data-urlencode "t_invoice=000000000000" \
--header "Accept: application/json"HTTP 상태만으로 업무 성공을 판단하지 마세요. 정상 배송 응답은 result를, 호환 업무 오류는 status,
code, msg를 확인해야 합니다.