Skip to main content
현재 계정의 API 호출 상세 내역을 CSV로 직접 다운로드하며, 재무 대조, 오프라인 분석 또는 대량 기록 보관에 적합합니다. 페이지에서 소량의 상세 내역만 확인해야 하는 경우 먼저 호출 기록 목록을 사용하세요.

준비 작업

  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든 발견하면 파일을 불완전한 것으로 간주해야 하며, 조용히 반영해서는 안 됩니다.

오류 및 재시도

다음 단계