응답 형식

지원 endpoint는 JSON과 XML content negotiation을 제공합니다. Accept header를 생략하거나 */*를 보내면 JSON이 기본값입니다.

요청 `Accept`	응답 `Content-Type`
`application/json`	`application/json;charset=UTF-8`
`application/xml`	`application/xml;charset=UTF-8`
`text/xml`	`application/xml;charset=UTF-8`
생략 또는 `/`	`application/json;charset=UTF-8`

curl --get "$TAEKMANI_BASE_URL/api/v1/companylist" \
  --data-urlencode "t_key=$TAEKMANI_API_KEY" \
  --header "Accept: application/xml"

지원하지 않는 형식을 요청하면 HTTP 406 Not Acceptable을 반환하며 body 형식은 보장하지 않습니다.

계약 차이

JSON과 XML은 SweetTracker 호환 계약을 유지하므로 단순한 key 변환 관계가 아닙니다.

company list JSON은 Company[].Code, International, Name을 사용하고 XML은 Name, Code만 제공합니다.
tracking JSON은 null field와 상세 alias를 유지합니다.
tracking XML은 null field를 생략하지만 빈 문자열 element는 유지합니다.
업무 오류 JSON은 code, XML은 capitalized Code를 사용합니다.

따라서 하나의 공통 model로 무리하게 변환하지 말고 선택한 format의 문서 계약대로 parsing하세요.