메인 콘텐츠로 건너뛰기
현재 계정의 API 호출 상세 내역을 CSV로 직접 다운로드하며, 재무 대조, 오프라인 분석 또는 대량 기록 보관에 적합합니다. 페이지에서 소량의 상세 내역만 확인해야 하는 경우 먼저 호출 기록 목록을 사용하세요. 호출 기록 및 청구 요약의 조회 범위는 최근 60일이며, 요청 및 응답 본문은 별도로 최근 30일 동안 보관됩니다. 본문 만료는 해당 기록의 실제 차감, 사용량 또는 집계 통계를 변경하지 않습니다.

준비 작업

  1. AceDataCloud 플랫폼에 로그인합니다.
  2. Account Token 콘솔에서 계정 토큰을 생성하고, 즉시 비밀번호 관리자 또는 Secret Manager에 저장합니다.
  3. 필요에 따라 서비스 신청 목록, API 자격 증명 목록 또는 API 목록에서 필터링 ID를 가져옵니다.
전체 토큰 설명은 계정 토큰 관리를 참조하세요. 계정 토큰과 비즈니스 API 호출에 사용하는 Credential은 혼용할 수 없습니다.

인터페이스 개요

이 인터페이스는 CSV를 동기식 스트리밍으로 반환하며, 내보내기 작업을 생성하지 않고 JSON 또는 다운로드 링크도 반환하지 않습니다. 시작 및 종료 시간이 모두 제공되지 않은 경우에만 현재 자연월 시작부터 현재 시각까지의 기록을 기본으로 내보냅니다. 한쪽 경계만 제공된 경우 다른 쪽은 이번 달 경계로 자동 보완되지 않습니다.

쿼리 매개변수

내보내기 범위는 항상 현재 계정이 결제 주체 및/또는 실제 호출자로서 볼 수 있는 기록으로 제한되며, 계정 간 내보내기는 지원하지 않습니다.

요청 예시

현재 월 CSV를 직접 저장합니다:
Application, 시간 및 상태 코드별로 내보냅니다:
Python으로 스트리밍 저장 및 무결성을 확인합니다:

CSV 열

CSV 헤더 순서는 고정되어 있습니다:
한도 단위는 해당 Application의 service.unit에 따라 결정됩니다.

내보내기가 완료되었는지 판단하기

한 번에 최대 1,000,000개의 데이터를 출력합니다. 서버가 이미 CSV 반환을 시작한 후에는 중간 오류를 다른 HTTP 상태로 변경할 수 없으므로 클라이언트는 마지막 줄을 반드시 확인해야 합니다:
  • # truncated::행 수 상한에 도달함; 더 작은 시간 창으로 나누어 내보냅니다.
  • # error::스트리밍 읽기가 중단됨; 범위를 줄인 후 다시 내보냅니다.
대조 프로그램은 어느 marker라도 발견하면 반드시 파일을 불완전한 것으로 간주해야 하며, 조용히 장부에 반영해서는 안 됩니다.

오류 및 재시도

다음 단계