Workers: Cloudflare APIで一時アカウントを作成可能に
Key Points
- APIで一時アカウント作成
- ログイン不要でプレビュー可能
- クレームURLで恒久化
Summary
CloudflareはREST APIで一時プレビューアカウント(Temporary Accounts)を作成できる機能を提供します。これにより、プラットフォーム側でユーザーがCloudflareにサインインしていなくても、生成したWorkerや対応リソースをデプロイ・テスト・共有でき、後でユーザーがクレームURLから恒久化できます。
Key Points
- 目的: プラットフォーム内のオンボーディングでユーザーを離脱させずに、生成したアプリを即時デプロイ・プレビューさせる。
- 主なフロー: 1) 利用規約とプライバシーポリシーを表示し同意を得る 2) 証明(proof-of-work)チャレンジを取得して解く 3)
POST /provisioning/previewsで一時アカウントを作成 4) 返却された一時アカウントIDとAPIトークンでデプロイ 5) デプロイURLとクレームURLをユーザーに提示して恒久化を促す。 - 実装上の注意: バックエンドでプロビジョニングとチャレンジ解決を管理し、CloudflareのToS/Privacy表示とユーザー同意を必須にすること。
- 範囲: Workersや静的サイトなどを対象(例: Cloudflare Dropは1時間のプレビュー→クレームで恒久化)。詳細なproof-of-work要件やサポート製品、レート/制限は公式ドキュメントを参照。
Practical checklist for engineers
- バックエンドにてチャレンジ取得:
POST https://api.cloudflare.com/client/v4/provisioning/previews/challenge - 一時アカウント作成:
POST https://api.cloudflare.com/client/v4/provisioning/previews(termsOfService,privacyPolicy,acceptTermsOfService,challengeToken,solutionを送信) - 返却された
temporary_account_idとapi_tokenでデプロイAPIを呼び出す - ユーザーにデプロイ済みURLとクレームURLを表示し、クレームによる恒久化フローを案内する
詳細(proof-of-work・制限・サポート製品)は公式ドキュメント「Claim deployments (temporary accounts)」および「Temporary Cloudflare Accounts for AI agents」を参照してください。