メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://factory-apigettingstarted.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Factory Public APIは、Droid CLIとFactory Appを動かしているのと同じプリミティブ（コンピューター、セッション、組織設定）を公開しています。Droid環境のプロビジョニング、セッションのプログラム制御、組織レベルのリソース管理を、ご自身のシステムから実行できます。

​
認証

すべてのリクエストには、AuthorizationヘッダーにFactory APIキーが必要です： 
Authorization: Bearer fk-your-api-key

​
APIキーの生成

  1. Factory Appに app.factory.ai でサインインします。
  2. app.factory.ai/settings/api-keys を開きます。
  3. Create API key をクリックし、わかりやすい名前を付けて、値（fk- で始まる文字列）をコピーします。
キーは一度だけ表示されます。シークレットマネージャーまたは環境変数に保存してください。パスワードと同様に扱い、ソース管理にコミットしたり、共有ログに貼り付けたりしないでください。 
export FACTORY_API_KEY="fk-your-api-key"
Factory APIキー設定画面

​
権限

APIキーの作成とPublic APIの呼び出しが可能なのは、Manager または Owner ロールのユーザーのみです。メンバーとゲストは 403 Forbidden レスポンスを受け取ります。 APIキーは作成したユーザーのロールを継承します。チームメンバーのロールが変更されたり組織を離れたりした場合は、app.factory.ai/settings/api-keys からキーを失効させてください。

​
利用可能なエンドポイント

Public APIは3つのリソースグループに分かれています：
グループ説明
Computers永続的なDroidコンピューター環境のプロビジョニング、一覧、再起動、削除
Sessionsセッションの作成、メッセージの投稿、セッション履歴の取得
Organization組織ユーザー、使用量上限、エンタープライズコントロール履歴の管理
各グループのエンドポイントリファレンスは、左サイドバーから参照できます。

​
次のステップ

コンピューター一覧

組織内の既存のDroidコンピューター環境を確認します

セッションの作成

ご自身のシステムからDroidをプログラム制御します

組織ユーザーの管理

管理者ワークフロー向けに組織メンバーを招待、削除、設定します