시간 형식
API 응답에서 시간 관련 필드는 두 가지 형식으로 반환됩니다.
| 형식 | 예시 | 사용 필드 | 타임존 |
|---|---|---|---|
YYYY-MM-DD | 2026-03-24 | validity.from, validity.to | KST 고정 |
| ISO 8601 | 2026-03-24T17:00:00.000+09:00 | createdAt, sentAt, canceledAt, usedAt 등 | Time-Zone 헤더에 따름 |
Time-Zone 헤더
Time-Zone 헤더로 ISO 8601 타임스탬프의 타임존을 설정할 수 있습니다.
| 헤더 값 | 응답 형식 | 예시 |
|---|---|---|
없음 또는 Asia/Seoul | KST (+09:00) | 2026-03-24T17:00:00.000+09:00 |
UTC | UTC (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 기준입니다.