본문으로 건너뛰기

시간 형식

API 응답에서 시간 관련 필드는 두 가지 형식으로 반환됩니다.

형식예시사용 필드타임존
YYYY-MM-DD2026-03-24validity.from, validity.toKST 고정
ISO 86012026-03-24T17:00:00.000+09:00createdAt, sentAt, canceledAt, usedAtTime-Zone 헤더에 따름

Time-Zone 헤더

Time-Zone 헤더로 ISO 8601 타임스탬프의 타임존을 설정할 수 있습니다.

헤더 값응답 형식예시
없음 또는 Asia/SeoulKST (+09:00)2026-03-24T17:00:00.000+09:00
UTCUTC (Z)2026-03-24T08:00:00.000Z
# UTC로 응답받기
curl -u "test_sk_your_key_here:" \
-H "Time-Zone: UTC" \
"https://api.aiconbiz.kr/v1/coupons/issued?id=iss_018d8f3a..."
날짜 필드는 항상 KST입니다

validity.from, validity.to 같은 YYYY-MM-DD 형식의 날짜 필드는 Time-Zone 헤더와 관계없이 항상 KST 기준입니다.