메인 콘텐츠로 건너뛰기
계정이 소유하거나 사용 권한을 부여받은 Application을 페이지네이션으로 반환하며, 잔액, 상태, 서비스 요약 및 연결된 자격 증명을 포함합니다. 대량 잔액 모니터링, Application ID 찾기 및 자격 증명 관리 진입에 적합합니다.

준비 작업

  1. AceDataCloud 플랫폼에 로그인합니다.
  2. Account Token 콘솔에서 계정 토큰을 생성합니다.
  3. 일반 사용자는 user_id=me를 사용합니다. 또는 GET /api/v1/platform-tokens/me/에서 자신의 UUID를 가져올 수 있습니다.

인터페이스 개요

일반 사용자는 user_id=me를 전달해야 합니다. 전달하지 않으면 쿼리가 먼저 계정별로 좁혀지지 않으며, 페이지네이션 중 권한 없는 객체를 만나면 403이 반환될 수 있습니다. 관리자는 전달하지 않아도 전체 테이블을 볼 수 있습니다.

쿼리 매개변수

paid, disabled, expired, low_balance 및 tag는 현재 서버 측 필터링 매개변수가 아닙니다. 잔액 알림은 목록을 가져온 후 각 Application의 remaining_amount, service.unit 및 비즈니스 임계값에 따라 클라이언트에서 판단해야 합니다.

요청 예시

자신이 소유한 Application과 다른 사람이 자신에게 권한을 부여한 Application을 동시에 확인합니다:

응답 설명

응답은 {count, items}입니다. 각 항목에는 Application 모델 필드와 다음이 추가로 포함됩니다:
  • service: id, alias, title, type, unit, icon_url;
  • credentials: 현재 호출자가 볼 권한이 있는 자격 증명 요약;
  • paid, remaining_amount, used_amount, disabled, allow_consume_global, allow_overdraft;
  • scope의 실제 값은 Individual 또는 Global;
  • type의 실제 값은 Usage 또는 Period.
allow_overdraft는 관리자가 제어하는 읽기 전용 불리언 필드이며, 기본값은 false입니다. 초과 인출이 활성화된 사용량 기반(Usage) 애플리케이션의 경우 잔액 부족이 호출을 차단하지 않으며, 실제 사용량에 따라 계속 청구됩니다. 음수 잔액은 정산 대기 한도를 나타냅니다. 비활성화, 만료 및 API 자격 증명 한도는 계속 적용됩니다. remaining_amount는 비어 있을 수 있습니다. 클라이언트는 반드시 먼저 빈 값인지 확인한 후 숫자 비교를 해야 합니다. 한도 단위는 service.unit에 의해 결정됩니다.

다음 단계