Skip to main content
GET
프로젝트 사용량 가져오기

개요

현재 크레딧 사이클에 대한 프로젝트의 크레딧 소비에 대한 전체 그림을 반환하며, 남은 크레딧, 구독 계획 세부 정보 및 서비스 유형(RPC, DAS, gRPC, WebSocket 등)별 요청 분류를 포함합니다. 모든 크레딧 수치는 creditCycle에 맞추어 범위가 지정됩니다 — 크레딧이 누적되고 다시 설정되는 창으로, 구독의 청구 앵커에서 파생됩니다. 모든 프로젝트에는 하나가 포함되어 있으며, 무료 계획도 포함됩니다. subscriptionDetails.billingCycle은 송장 창이며 정보 제공 목적으로 사용됩니다. 청구되지 않는 무료 계획에는 적용되지 않습니다.

요청 매개변수

string
필수
사용량을 검색할 프로젝트 ID입니다. 인증에 사용되는 API 키와 연결된 프로젝트와 일치해야 합니다.

응답 필드

number
현재 크레딧 사이클에 남아 있는 크레딧입니다. 플랜의 크레딧 한도에서 사용된 일반 크레딧을 뺀 값으로, 0으로 바닥에 맞춰 계산됩니다.
number
현재 크레딧 사이클에 소비된 총 크레딧으로, 일반 크레딧과 선불 크레딧이 모두 포함됩니다.
number
아직 사용 가능한 선불 크레딧입니다.
number
현재 크레딧 사이클에 소비된 선불 크레딧입니다.
object
이 응답의 모든 크레딧 수치가 범위에 맞춰진 창입니다 — 크레딧이 누적되고 다시 설정되는 기간으로, 구독의 청구 앵커에서 파생됩니다. 모든 계획에 대해 항상 존재하며, 무료 계획도 포함됩니다.
string
YYYY-MM-DD 형식의 크레딧 사이클 시작 날짜 (UTC).
string
YYYY-MM-DD 형식의 크레딧 사이클 종료 날짜 (UTC).
object
구독 계획 및 청구 사이클 정보입니다.
object | null
현재 청구 사이클의 시작 및 종료 날짜입니다. 정보 제공 목적으로만 사용되며 — 무료 계획에는 적용되지 않습니다. 유료 계획에서는 보통 creditCycle와 일치합니다.
string
YYYY-MM-DD 형식의 청구 사이클 시작 날짜.
string
YYYY-MM-DD 형식의 청구 사이클 종료 날짜.
number
플랜에 따라 크레딧 사이클에 대한 총 크레딧 허용량입니다.
string
구독 계획의 이름입니다 (예: "business", "professional").
object
현재 크레딧 사이클에 대한 제품별 크레딧 소비로, 전체 크레딧 단위로 표시됩니다. 모든 제품을 다룹니다. 값은 계산된 원본이며 마지막에 한 번 반올림하여 청구와 일치하도록 하므로, 제품별 크레딧이 반올림 후 creditsUsed에 정확히 합산되지 않을 수 있습니다.
number
표준 Solana RPC에 의해 소비된 크레딧입니다.
number
Enhanced API(예: 분석된 트랜잭션, 토큰 메타데이터)에 의해 소비된 크레딧입니다.
number
Wallet API에 의해 소비된 크레딧입니다.
number
DAS(Digital Asset Standard) API에 의해 소비된 크레딧입니다.
number
Webhooks에 의해 소비된 크레딧입니다.
number
LaserStream gRPC(대역폭 기준)에 의해 소비된 크레딧입니다.
number
LaserStream WebSocket(대역폭 기준)에 의해 소비된 크레딧입니다.
number
선확인에 의해 소비된 크레딧입니다.
number
Archival에 의해 소비된 크레딧입니다.
number
Photon (ZK Compression)에 의해 소비된 크레딧입니다.
number
분류되지 않은 사용에 의해 소비된 크레딧입니다.
object
요청 수는 요청 기반 제품에 대해 현재 크레딧 사이클에 대한 것입니다. 대역폭 기준 LaserStream 제품(laserstreamGrpc, laserstreamWebsocket)은 여기 나타나지 않으며 dataTransfer를 참조하십시오. 필드: rpc, enhancedApi, walletApi, das, webhooks, preConfirmations, archival, photon, other.
object
대역폭 기준 LaserStream 제품에 대한 현재 크레딧 사이클 동안 전송된 바이트수입니다. 이 제품들은 요청 수가 아닌 전송된 데이터로 청구되므로 여기와 credits에 나타나지만, requests에는 절대 나타나지 않습니다. 필드: laserstreamGrpc, laserstreamWebsocket.

요청 매개변수

string
필수
사용량을 검색할 프로젝트 ID입니다. API 키와 연결된 프로젝트와 일치해야 합니다.

인증

api-key
string
query
필수

쿼리 매개 변수로 전달된 API 키입니다.

경로 매개변수

id
string<uuid>
필수

사용량을 검색할 프로젝트 ID입니다. API 키와 연관된 프로젝트와 일치해야 합니다.

예시:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

응답

프로젝트 사용량을 성공적으로 검색했습니다.

creditsRemaining
number

현재 크레딧 주기에서 남아 있는 크레딧 수. creditsLimit - regularCreditsUsed로 계산되며, 0으로 내림 됩니다.

예시:

487500

creditsUsed
number

현재 크레딧 주기에서 소모된 총 크레딧 수로, 일반 및 선불 크레딧 모두를 포함합니다.

예시:

12500

prepaidCreditsRemaining
number

남아 있는 선불 크레딧 수.

예시:

50000

prepaidCreditsUsed
number

현재 크레딧 주기에서 소모된 선불 크레딧 수.

예시:

0

creditCycle
object

이 응답의 모든 크레딧 수치가 적용되는 기간 — 크레딧이 축적되고 초기화되는 기간으로, 구독의 청구 기준 날짜에서 도출됩니다. 모든 계획에 대해 항상 존재하며, 청구되지 않는 무료 계획도 포함됩니다.

subscriptionDetails
object

프로젝트의 구독 계획 및 청구 주기에 대한 세부 정보입니다.

credits
object

현재 크레딧 주기 동안 각 제품의 크레딧 소비량을 정수로 나타냅니다. 모든 제품을 포괄합니다. 값은 원시 상태로 누적되며, 청구와 일치하도록 마지막에 한 번 반올림됩니다. 따라서 반올림 후 각 제품의 크레딧이 creditsUsed와 정확히 일치하지 않을 수 있습니다.

requests
object

현재 크레딧 주기 동안 요청 기반 제품에 대해서만 요청 수를 나타냅니다. 대역폭 기반 LaserStream 제품(laserstreamGrpc, laserstreamWebsocket)은 여기 나타나지 않으며, dataTransfer를 참조하세요.

dataTransfer
object

대역폭 기반 LaserStream 제품에 대해서만 현재 크레딧 주기 동안 전송된 바이트 양입니다. 이러한 제품은 요청 수가 아니라 전송된 데이터로 청구되므로 여기 및 credits에 나타나지만 requests에는 전혀 나타나지 않습니다.