フロー概要
- あなたのサーバーから Partner API キーを使ってセッション作成エンドポイントを呼び出します。
- Turnint AI はワンタイム認証コード付きのログイン URL を返します。
- ユーザーのブラウザをそのログイン URL にリダイレクトします。
- ダッシュボードが認証コードを自動的に検証し、セッションを発行します。
- ユーザーはログイン画面を経由せず、ダッシュボードにアクセスできます。
前提条件
- Partner API キー(
ptn_sk_xxxx)が発行済みであること
API リファレンス
セッション作成
リクエストボディ
リクエスト例
レスポンス
セッション無効化
指定した namespace のすべてのセッションを無効化します。リクエストボディ
レスポンス
実装例
Node.js / TypeScript
cURL
namespace とワークスペース
namespace はパートナーのテナントと Turnint AI のワークスペースを紐付けるキーです。
- 同じ
namespaceで複数回セッションを作成しても、同一のワークスペースが使用されます。 - 新しい
namespaceを指定すると、自動的に新しいワークスペースが作成されます。
セキュリティ
- 認証コードはワンタイム — 1 回使用されると即座に無効化されます。
- 認証コードの有効期限は 5 分 — 発行後 5 分以内にリダイレクトを完了してください。
- ロール制限 — パートナーに許可されたロールのみ指定可能です。許可されていないロールを指定すると
400 Bad Requestが返されます。

