일별 청구서 조회
인터페이스 모듈
일별 청구서 조회
날짜별 청구서 소비 상세 및 일 요약 데이터를 조회하여 정산, 비용 분석, 청구서 수집에 사용
GET
일별 청구서 조회
날짜별로 청구서의 소비 상세와 일 요약 데이터를 조회하여 클라이언트 측 정산, 비용 분석, 청구서 수집에 사용합니다.
엔드포인트 정보
엔드포인트 목록
인증
모든 요청은 HTTP Header에 Bearer 자격 증명을 포함해야 합니다. 다음 두 가지 자격 증명 중 하나를 선택할 수 있습니다:string
필수
형식
Bearer <자격증명>; 위 자격 증명 중 하나를 입력401, 비즈니스 코드 40100을 반환합니다.
공통 응답 구조
모든 엔드포인트는 통일된 구조를 반환합니다:비즈니스 오류 코드
소비 상세 조회
(청구일 × 계정 × 모델 × Token 유형) 기준으로 소비 상세를 반환합니다.
쿼리 파라미터
string
필수
시작 날짜, 형식
yyyy-MM-ddstring
필수
종료 날짜, 형식
yyyy-MM-dd; startDate와의 기간은 92일을 초과할 수 없음string
필수
페이지 크기, 양의 정수 문자열; 범위
1 ~ 100, 100 초과 시 100으로 처리string
필수
현재 페이지 번호, 양의 정수 문자열,
1부터 시작페이지네이션 단위는 「소비 상세 항목」이며,
data.total은 조건을 만족하는 상세 총 건수입니다.응답 행 필드 (data.rows[])
tokenType enum
정렬 규칙:
billDay 내림차순, 이어서 account, modelName, tokenType, currency 오름차순.요청 예시
응답 예시
일 요약 조회
쿼리 파라미터
string
필수
시작 날짜, 형식
yyyy-MM-ddstring
필수
종료 날짜, 형식
yyyy-MM-dd; startDate와의 기간은 366일을 초과할 수 없음string
필수
페이지 크기, 양의 정수 문자열; 범위
1 ~ 400, 400 초과 시 400으로 처리string
필수
현재 페이지 번호, 양의 정수 문자열,
1부터 시작페이지네이션 단위는 「청구일 × 계정」이며,
data.total은 조건을 만족하는 조합 총수입니다.응답 행 필드 (data.rows[])
정렬 규칙:
billDay 내림차순, 이어서 account 오름차순.요청 예시
응답 예시
비즈니스 규칙과 약정
- 금액 정밀도: 모든 금액 필드는
string으로 전송하며 소수점 8자리를 유지하여 JSON number 정밀도 손실을 방지합니다. - 금액 일관성: 동일 청구일·동일 계정에서, 일 요약의 각 금액 필드는 해당일 소비 상세의 대응 금액 필드 합과 같습니다 (페이지를 넘어 합산).
- 제로 소비일: 조회 구간 내 소비가 없는 날짜는 기록을 반환하지 않습니다.
- 데이터 지연: 청구서 데이터는 T+1이며, 최신 하루 데이터는 다음 날에 조회 가능합니다.
- 계정 범위와 기업 관리: 기본적으로 자격 증명은 자신의 계정 청구서만 조회할 수 있습니다. 해당 계정이 「기업 관리」를 개통하고 주 계정인 경우, 하위 전체 계정의 청구서를 볼 수 있습니다 — 이때
userId/userName를 미전달하면 전체 하위 계정을 반환하고, 전달하면 지정 하위 계정으로 필터링합니다 (하위 계정 자신의 자격 증명은 본인만 조회 가능). 기업 관리 개통은 플랫폼 관리자에게 문의하세요. - 페이지 범위 초과:
pageNum이 총 페이지 수를 초과하면 빈rows를 반환하며,total은 실제 총수를 유지합니다.
