Skip to main content
「신청(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을 재사용하세요.

관련 인터페이스