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 プラットフォームチャージ注文を作成 — 無料クレジットを使い切った後にチャージ

