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 플랫폼 충전 주문 생성 — 무료 한도 소진 후 충전
allow_overdraft는 기본적으로 비활성화되어 있으며 관리자가 별도로 권한을 부여합니다. Application 생성 시 요청 파라미터를 통해 직접 활성화할 수 없습니다.
