Playground
任意の公開済みオートメーションを選び、型付き入力を入力して実行します。このプロダクト内での試用にAPIキーは不要です。- 型付き入力 — フォームはオートメーション自身の入力スキーマ（オーサリング中に記録されたものと同じ
{{slot}}名）から生成されるため、送信できる値はエンドポイントが受け付ける値そのものです。 - ライブ結果 — レスポンスはJSONとして返り、どの手順が実行され、各手順にどれだけ時間がかかり、何が変わったかを示す実行トレースも一緒に表示されます。呼び出しが進行中の間、状態は実行中と表示され、完了すると成功または失敗と表示されます。
- ループ内にモデルはありません — Playgroundでの実行は、実際の呼び出し元が呼び出すものとまったく同じ決定論的エンドポイントを呼び出します。表示される内容は、本番環境が返す内容です。
Playgroundは探索とデバッグのためのものです。自分のサービスからオートメーションを呼び出すには、
POST /v1/run/:flow に対してBearer APIキーを使います。正確なリクエスト/レスポンス形状はDocsページを読むを参照してください。PlaygroundのAPIキーフィールドはパスワード入力であり、リクエストパネルの
curl スニペットは、フィールドが実際の値を保持していても、常にBearerトークンをマスクします（例: Bearer jbt_live_••••3f9a）。実際のキーを含む実行可能なコマンドを取得するには、パネルのコピーボタンを使ってください。画面上のテキストに平文で表示されることはありません。同じマスク処理は、レスポンスの出力パネル内にあるシークレットらしい値にも適用されます。APIキー
APIキー画面では、/v1/run/* と /mcp への呼び出しを認証するBearerキーを発行および取り消します。
- キー形式: 本番呼び出し用のキーには
jbt_live_…、テストモード呼び出し用のキーにはjbt_test_…というプレフィックスが付き、その後にランダムなシークレットが続きます。例:jbt_live_••••3f9a。 - 表示は一度だけ。 平文のキーは作成時にだけ、1回限りの「今すぐコピー」パネルに表示されます。Jinba Trailが保存するのはソルト付きハッシュのみです。平文を失った場合は、キーを取り消して新しいキーを発行してください。ページを離れる（または再読み込みする）と、平文は完全に失われます。
- 組織にスコープされます。 キーはあなたの組織として認証します。その組織が所有するオートメーションだけを呼び出せます。
- いつでも取り消せます。 キーを取り消すと即座に有効になります。そのキーをまだ使っている呼び出し元は
401 unauthorizedを受け取り始めます。 - オーナーのみ。 キーの発行または取り消しにはorganization-ownerロールが必要です。他のロールはキー一覧を表示できますが、作成/取り消し操作は無効になります。
キーを特定のオートメーションにスコープする
デフォルトでは、新しいキーはスコープなしです。組織内のすべての公開済みオートメーションを呼び出せます。キーを作成するときに、代わりに特定のオートメーションの許可リストにチェックを入れることができます。これはスコープ付きキーであり、選択したものだけを実行できます。単一の連携または単一のスクリプトに渡すキーとしては、最小権限の選択肢です。- すべてのチェックボックスをチェックなしのままにすると、キーはスコープなし（すべての公開済みオートメーション）のままです。これはスコープ機能が存在する前に発行されたすべてのキーの挙動でもあるため、すでにデプロイされているものは何も変わりません。
- 1つ以上のオートメーションにチェックを入れると、キーはオートメーション名ごとに、その許可リストだけに固定されます。
- キー一覧では、各キーのスコープがバッジとして表示されます。表示は「すべての自動化」または「3件の自動化」のような件数で、ホバーすると完全なリストが表示されます。
次のステップ
Docsページを読む
各オートメーションごとに生成される完全なリクエスト/レスポンスリファレンス。
サイトが変更された場合 - 再記録
失敗した呼び出しが何を意味し、どう修正するか。