API 키 이용량

API 키에 연결된 이용권의 전체량, 잔여량과 사용 기간을 반환합니다. 다른 호환 endpoint와 달리 API 키를 key request header로 전달합니다.

요청

Parameter	위치	필수	설명
`key`	header	예	발급받은 API 키 원문

curl "$TAEKMANI_BASE_URL/api/v1/key/usage" \
  --header "key: $TAEKMANI_API_KEY" \
  --header "Accept: application/json"

JSON 응답

{
  "key": "tmk_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
  "totalAmount": 1000,
  "leftAmount": 321,
  "startDate": "2026-01-02 03:04:05",
  "endDate": "2028-01-02 03:04:05"
}

XML 응답

<?xml version="1.0" encoding="UTF-8"?>
<APIKeyUsage>
  <key>tmk_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA</key>
  <totalAmount>1000</totalAmount>
  <leftAmount>321</leftAmount>
  <startDate>2026-01-02 03:04:05</startDate>
  <endDate>2028-01-02 03:04:05</endDate>
</APIKeyUsage>

응답에는 요청에 사용한 API 키 원문이 포함됩니다. response body를 application log, analytics 또는 error report에 남기지 마세요.

상태 코드

HTTP	설명
`200`	이용량과 기간 반환
`404`	API 키 또는 연결된 이용권을 찾을 수 없음
`406`	지원하지 않는 응답 형식
`500`	내부 오류, body 없음

요청

JSON 응답

XML 응답

상태 코드

On this page