메인 콘텐츠로 건너뛰기
「신청(Application)」은 현재 계정의 특정 서비스에 대한 구독 관계를 의미합니다. 먼저 신청해야만 해당 신청에 대한 API 자격 증명을 생성하고 비즈니스 인터페이스를 호출할 수 있습니다. 특정 서비스를 처음 신청할 때 Application은 해당 서비스에 현재 설정된 free_amount를 받습니다. 이 값은 0일 수 있습니다.
ℹ️ 이 인터페이스는 AceDataCloud 플랫폼 관리 API에 속하며, 통합 접두사는 https://platform.acedata.cloud/api/v1/입니다. 전체 인터페이스 색인은 AceDataCloud 플랫폼 문서 목록 가져오기를 참조하세요.

전체 연동 절차

신규 사용자가 등록부터 첫 번째 비즈니스 인터페이스 호출 성공까지, 일반적으로 다음 5단계를 거칩니다.
  1. 계정 토큰 획득 → AceDataCloud 플랫폼 계정 토큰 관리
  2. 서비스 선택 → AceDataCloud 플랫폼 서비스 목록 가져오기
  3. 신청 생성(본 문서) → 서비스 구성에 따라 초기 할당량 획득
  4. API 자격 증명 생성 → AceDataCloud 플랫폼 API 자격 증명 생성
  5. 비즈니스 인터페이스 호출 → 획득한 32자리 Token으로 https://api.acedata.cloud/<path> 호출

인터페이스 개요

인증 설명(계정 토큰 획득 방법)

요청 헤더:
계정 토큰(Account Token)은 개발자가 API를 통해 자신의 계정 리소스를 관리하기 위한 “계정 수준 키”입니다. 획득 방법:
  1. 콘솔에서 원클릭 생성(권장): AceDataCloud 플랫폼에 로그인 → Account Token 콘솔 → 「생성」을 클릭하면 platform-v1-로 시작하는 토큰을 획득할 수 있습니다.
  2. API 생성: 기존 계정 토큰 또는 브라우저 로그인 상태 JWT로 POST /api/v1/platform-tokens/를 호출합니다. 자세한 내용은 AceDataCloud 플랫폼 계정 토큰 관리를 참조하세요.
⚠️ 계정 토큰은 비밀번호와 동일한 수준으로 민감하므로, 프론트엔드 코드 또는 공개 저장소에 작성하는 것을 금지합니다. 유출된 경우 즉시 콘솔에서 삭제하고 재생성하세요.

요청 본문

요청 예시

cURL

Python

Node.js

응답 예시

성공(HTTP 201)

반환 필드 구조는 AceDataCloud 플랫폼 서비스 신청 상세 가져오기와 일치합니다.

이미 신청됨(HTTP 400)

이것은 설계상의 하드 제한입니다: 각 사용자는 각 서비스에 대해 하나의 Application만 가질 수 있습니다. 이미 존재하는 경우 AceDataCloud 플랫폼 서비스 신청 목록 가져오기를 통해 기존 신청을 찾으세요.

서비스를 찾을 수 없음(HTTP 404)

서비스에 심사가 필요함(HTTP 403)

서비스의 need_verify=true인 경우(서비스 목록에서 해당 필드를 확인할 수 있음), 티켓 절차를 통해 화이트리스트를 신청해야 합니다.

오류 처리

오류 응답 통일 형식:

실용적인 팁

  • 생성 자체에는 비용이 청구되지 않습니다: 최초 생성 시 서비스의 현재 free_amount에 따라 초기 한도가 설정됩니다. 이 값은 0일 수 있으며, 동일 유형의 Application을 다시 생성하더라도 중복으로 제공된다는 보장은 없습니다.
  • 결제 필요 여부는 paid 필드를 확인하세요: 방금 신청했을 때는 paid=false이며, AceDataCloud 플랫폼 충전 주문 생성을 호출하여 결제를 완료하면 true로 변경됩니다.
  • disabled=true는 일시적으로 비활성화되었음을 의미합니다—예를 들어 리스크 관리 트리거, 미납 등입니다. 비활성화된 경우 비즈니스 인터페이스는 403을 반환합니다.
  • 무제한 동시 생성하지 마세요: 먼저 페이지네이션된 서비스 목록에서 대상 service_id를 가져온 후, 비즈니스 필요에 따라 항목별로 신청하세요. duplication이 발생하면 기존 Application을 재사용하세요.

관련 인터페이스

allow_overdraft는 기본적으로 비활성화되어 있으며 관리자가 별도로 권한을 부여합니다. Application 생성 시 요청 파라미터를 통해 직접 활성화할 수 없습니다.