free_amount를 받습니다. 이 값은 0일 수 있습니다.
ℹ️ 이 인터페이스는 AceDataCloud 플랫폼 관리 API에 속하며, 공통 접두사는 https://platform.acedata.cloud/api/v1/입니다. 전체 인터페이스 인덱스는 AceDataCloud 플랫폼 문서 목록 가져오기를 참조하세요.
전체 연동 절차
신규 사용자가 등록부터 첫 번째 비즈니스 인터페이스 호출 성공까지 일반적으로 다음 5단계를 거칩니다.- 계정 토큰 획득 → AceDataCloud 플랫폼 계정 토큰 관리
- 서비스 선택 → AceDataCloud 플랫폼 서비스 목록 가져오기
- 신청 생성(이 문서) → 서비스 구성에 따라 초기 할당량 획득
- API 자격 증명 생성 → AceDataCloud 플랫폼 API 자격 증명 생성
- 비즈니스 인터페이스 호출 → 획득한 32자리 Token으로
https://api.acedata.cloud/<path>호출
인터페이스 개요
인증 설명(계정 토큰 획득 방법)
요청 헤더:- 콘솔에서 원클릭 생성(권장): AceDataCloud 플랫폼에 로그인 → Account Token 콘솔 → 「생성」을 클릭하면
platform-v1-로 시작하는 토큰을 얻을 수 있습니다. - API 생성: 기존 계정 토큰 또는 브라우저 로그인 상태 JWT를 사용하여
POST /api/v1/platform-tokens/를 호출합니다. 자세한 내용은 AceDataCloud 플랫폼 계정 토큰 관리를 참조하세요.
⚠️ 계정 토큰은 비밀번호와 동일한 수준으로 민감하므로 프런트엔드 코드나 공개 저장소에 작성하는 것을 금지합니다. 유출된 경우 즉시 콘솔에서 삭제하고 재생성하세요.
요청 본문
요청 예시
cURL
Python
Node.js
응답 예시
성공(HTTP 201)
이미 신청됨(HTTP 400)
서비스가 존재하지 않음(HTTP 404)
서비스에 검토 필요(HTTP 403)
need_verify=true인 경우(서비스 목록에서 이 필드를 확인할 수 있음), 티켓 절차를 통해 화이트리스트를 신청해야 합니다.
오류 처리
오류 응답 통일 형식:
유용한 팁
- 생성 자체는 요금이 부과되지 않음: 최초 생성 시 서비스의 현재
free_amount에 따라 초기 한도가 설정됩니다. 이 값은 0일 수 있으며, 같은 유형의 Application을 다시 생성해도 중복으로 증정된다는 보장은 없습니다. - 결제 필요 여부는
paid필드 확인: 처음 신청할 때는paid=false이며, AceDataCloud 플랫폼 충전 주문 생성을 호출하여 결제를 완료한 후true로 변경됩니다. disabled=true는 일시적으로 비활성화되었음을 의미—예를 들어 리스크 관리 트리거, 미납 등입니다. 비활성화된 경우 비즈니스 인터페이스는403을 반환합니다.- 무제한 병렬 생성을 하지 마세요: 먼저 페이지네이션 서비스 목록에서 대상
service_id를 가져온 후, 비즈니스 요구에 따라 항목별로 신청하세요.duplication이 발생하면 기존 Application을 재사용하세요.
관련 인터페이스
- AceDataCloud 플랫폼 서비스 목록 조회 — 먼저 서비스 선택
- AceDataCloud 플랫폼 서비스 신청 목록 조회 — 신청한 전체 항목 확인
- AceDataCloud 플랫폼 서비스 신청 상세 조회 — 단일 신청 확인
- AceDataCloud 플랫폼 API 자격 증명 생성 — 신청 성공 후 다음 단계
- AceDataCloud 플랫폼 충전 주문 생성 — 무료 한도 소진 후 충전

