Skip to main content
GET
일별 청구서 조회
날짜별로 청구서의 소비 상세일 요약 데이터를 조회하여 클라이언트 측 정산, 비용 분석, 청구서 수집에 사용합니다.

엔드포인트 정보

엔드포인트 목록

인증

모든 요청은 HTTP Header에 Bearer 자격 증명을 포함해야 합니다. 다음 두 가지 자격 증명 중 하나를 선택할 수 있습니다:
string
필수
형식 Bearer <자격증명>; 위 자격 증명 중 하나를 입력
인증 실패 시 HTTP 401, 비즈니스 코드 40100을 반환합니다.
URL, 프론트엔드 코드, 로그, 지원 티켓에 전체 키를 기록하지 마세요.

공통 응답 구조

모든 엔드포인트는 통일된 구조를 반환합니다:

비즈니스 오류 코드


소비 상세 조회

(청구일 × 계정 × 모델 × Token 유형) 기준으로 소비 상세를 반환합니다.

쿼리 파라미터

string
필수
시작 날짜, 형식 yyyy-MM-dd
string
필수
종료 날짜, 형식 yyyy-MM-dd; startDate와의 기간은 92일을 초과할 수 없음
string
계정 ID 필터 (다중 하위 계정 조회에는 「기업 관리」 개통 필요, 비즈니스 규칙 참고); 미전달 시 현재 자격 증명으로 볼 수 있는 계정 반환
string
계정명 필터, 정확 일치 (다중 하위 계정 조회에는 「기업 관리」 개통 필요, 비즈니스 규칙 참고); 미전달 시 현재 자격 증명으로 볼 수 있는 계정 반환
string
필수
페이지 크기, 양의 정수 문자열; 범위 1 ~ 100, 100 초과 시 100으로 처리
string
필수
현재 페이지 번호, 양의 정수 문자열, 1부터 시작
페이지네이션 단위는 「소비 상세 항목」이며, data.total은 조건을 만족하는 상세 총 건수입니다.

응답 행 필드 (data.rows[])

tokenType enum

정렬 규칙: billDay 내림차순, 이어서 account, modelName, tokenType, currency 오름차순.

요청 예시

응답 예시


일 요약 조회

일 단위 소비 순액 요약을 반환합니다. 상세 엔드포인트보다 응답이 가볍고, 청구서 개요, 일별 추이, 월간 리포트 등에 적합합니다.

쿼리 파라미터

string
필수
시작 날짜, 형식 yyyy-MM-dd
string
필수
종료 날짜, 형식 yyyy-MM-dd; startDate와의 기간은 366일을 초과할 수 없음
string
계정 ID 필터 (다중 하위 계정 조회에는 「기업 관리」 개통 필요, 비즈니스 규칙 참고); 미전달 시 현재 자격 증명으로 볼 수 있는 계정 반환
string
계정명 필터, 정확 일치 (다중 하위 계정 조회에는 「기업 관리」 개통 필요, 비즈니스 규칙 참고); 미전달 시 현재 자격 증명으로 볼 수 있는 계정 반환
string
필수
페이지 크기, 양의 정수 문자열; 범위 1 ~ 400, 400 초과 시 400으로 처리
string
필수
현재 페이지 번호, 양의 정수 문자열, 1부터 시작
페이지네이션 단위는 「청구일 × 계정」이며, data.total은 조건을 만족하는 조합 총수입니다.

응답 행 필드 (data.rows[])

정렬 규칙: billDay 내림차순, 이어서 account 오름차순.

요청 예시

응답 예시


비즈니스 규칙과 약정

  1. 금액 정밀도: 모든 금액 필드는 string으로 전송하며 소수점 8자리를 유지하여 JSON number 정밀도 손실을 방지합니다.
  2. 금액 일관성: 동일 청구일·동일 계정에서, 일 요약의 각 금액 필드는 해당일 소비 상세의 대응 금액 필드 합과 같습니다 (페이지를 넘어 합산).
  3. 제로 소비일: 조회 구간 내 소비가 없는 날짜는 기록을 반환하지 않습니다.
  4. 데이터 지연: 청구서 데이터는 T+1이며, 최신 하루 데이터는 다음 날에 조회 가능합니다.
  5. 계정 범위와 기업 관리: 기본적으로 자격 증명은 자신의 계정 청구서만 조회할 수 있습니다. 해당 계정이 「기업 관리」를 개통하고 주 계정인 경우, 하위 전체 계정의 청구서를 볼 수 있습니다 — 이때 userId/userName를 미전달하면 전체 하위 계정을 반환하고, 전달하면 지정 하위 계정으로 필터링합니다 (하위 계정 자신의 자격 증명은 본인만 조회 가능). 기업 관리 개통은 플랫폼 관리자에게 문의하세요.
  6. 페이지 범위 초과: pageNum이 총 페이지 수를 초과하면 빈 rows를 반환하며, total은 실제 총수를 유지합니다.