メインコンテンツへスキップ
「申請(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)

これは設計上の厳格な制限です:各ユーザーは各サービスに対して 1 つの 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 の作成時に、リクエストパラメータで自ら有効にすることはできません。