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)

これは設計上の厳格な制限です:各ユーザーは各サービスに対して 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 を再利用してください。

関連インターフェース