メインコンテンツへスキップ
Turnint AI のダッシュボードをマルチテナントシステムにホワイトラベルとして組み込むための仕組みです。エンドユーザーは Turnint AI のログイン画面を経由せず、シームレスにダッシュボードへアクセスできます。

フロー概要

  1. あなたのサーバーから Partner API キーを使ってセッション作成エンドポイントを呼び出します。
  2. Turnint AI はワンタイム認証コード付きのログイン URL を返します。
  3. ユーザーのブラウザをそのログイン URL にリダイレクトします。
  4. ダッシュボードが認証コードを自動的に検証し、セッションを発行します。
  5. ユーザーはログイン画面を経由せず、ダッシュボードにアクセスできます。

前提条件

  • Partner API キー(ptn_sk_xxxx)が発行済みであること

API リファレンス

セッション作成

リクエストボディ

リクエスト例

レスポンス

セッション無効化

指定した namespace のすべてのセッションを無効化します。

リクエストボディ

レスポンス

実装例

Node.js / TypeScript

cURL

namespace とワークスペース

namespace はパートナーのテナントと Turnint AI のワークスペースを紐付けるキーです。
  • 同じ namespace で複数回セッションを作成しても、同一のワークスペースが使用されます。
  • 新しい namespace を指定すると、自動的に新しいワークスペースが作成されます。

セキュリティ

  • 認証コードはワンタイム — 1 回使用されると即座に無効化されます。
  • 認証コードの有効期限は 5 分 — 発行後 5 分以内にリダイレクトを完了してください。
  • ロール制限 — パートナーに許可されたロールのみ指定可能です。許可されていないロールを指定すると 400 Bad Request が返されます。

エラーレスポンス