ホワイトラベルのエンドポイントとは、再販業者が自社の名前で売る API に追加するエンドポイントのことです。新しい機能ではありません。その API にすでにある操作のうちのいくつかを順に並べ、再販業者が選んだ 1 つのアドレスと 1 つの名前の背後に置いたものです。顧客はほかのものと同じように呼び出し、顧客のアシスタントは、ツールの一覧で、それを構成している操作と並んでいるのを目にします。
再販業者がこれを欲しがる理由
売っている商品が、たいてい 1 つの操作ではないからです。「リストをウォームアップしておきます」は、検索をして、結果ごとにリアクションを付け、それを書いた人たちに招待を送ることです。顧客のアシスタントが毎回、正しく、正しい順序で行わなければならない 4 回の呼び出しです。エンドポイントなら同じ作業が、1 回だけ名前を付けられ、再販業者自身の言葉で説明されます。
何から作れて、何から作れないか
再販業者自身のプランに含まれる操作だけです。自前のエンドポイントは、購入した API の中を通る近道であって、API を迂回する手段ではありません。プランの外にあるものを名指しするステップは、エンドポイントを書くときに拒否されます。実行するときではありません。
条件とループは使えます。式の言語は使えません。値は普通の JSON か、ここまでの実行結果から読み取るパスで、条件は比較です。何も評価されません。エンドポイントは顧客が書いて保存し、その後、提供元のサーバーで実際のアカウントに対して実行されるからです。
1 回の呼び出しで使える量
ループがあれば、エンドポイントは誰も意図しなかったほどの作業を求めることができます。そのため 1 回の実行には上限があります。操作の数、反復の数、そして時間です。上限に達することはエラーではなく、応答です。その応答には、すでに何が行われたかが書かれています。送信してしまったメッセージは取り消せないからです。
すべてのステップは新しいリクエストとして認可されます。そのため、最初のステップが作り出した ID は、2 番目のステップが使う前に、あらためて検証を通ります。組み合わせたエンドポイントは、中の操作が持つチェックを飛ばす手段ではなく、中の操作と同じペース配分の予算を消費します。
もう半分：こちらのものを外す
再販業者は、提供したくない操作を隠すこともできます。隠すと、その操作はツールの一覧、マニフェスト、リファレンスから外れます。ただしルートは引き続き応答するので、すでに呼び出している顧客が、一文で行った変更のせいで壊れることはありません。ある領域をまるごと消したい再販業者は、代わりにその領域の提供をやめます。
よくある質問
AI エージェントに、これを私の代わりに書いてもらえますか？
ふつうはその方法です。エンドポイントに何をさせたいか、自分のどの操作を使うかを説明すれば、アシスタントがステップを書いて保存します。プランに含まれない操作に手を伸ばした場合は、その操作の名前を挙げて拒否されるので、間違った推測は保存されずに直されます。
自前のエンドポイントは、実行に余計な費用がかかりますか？
中の操作にかかる費用と同じです。4 つの動作を行う 1 回の呼び出しは、それらを個別に行う 4 回の呼び出しと同じペース配分の予算を消費します。各ステップが、それぞれ 1 つのリクエストとして認可され、ペースを管理されるからです。