アクセストークンの取得 | Obtaining an access token アクセストークンの取得 | Obtaining an access token

アクセストークンの取得 | Obtaining an access token

最終更新日:

アクセストークンの取得 | Obtaining an access token

デジタルヒューマンとの会話セッションを開始するには、まず、お客様のプロセスは、お客様のウェブサイトとJavascript SDKがUneeQプラットフォームを認証するために使用する1回限りのアクセストークンを取得する必要があります。

 

カスタマーJWTトークン | Customer JWT token

1回限りの利用トークンを取得するためのプロセスでは、JWT暗号化(クライアント側)とJWT復号化(UneeQサーバ側)が必要になります。これを実現するためには、共有の JWT 秘密を双方が保有している必要があります。この JWT 秘密は、お客様のプラットフォーム テナントに関連付けられており、UneeQ からお客様に提供されたか、または、お客様が優先キーを UneeQ に提供することができます。

 

リクエストの仕様 | Request specification

アクセストークンを取得するには、POSTリクエストを以下のリクエストフォーマットを使用して /api/v1/clients/access/tokens に送信します。

ヘッダー | Headers

Key Value
Content-Type application/jwt
workspace 開始している会話のワークスペース会話 ID


ボディ | Body

このペイロードは、顧客のJWTトークンを使用して暗号化する必要があります。

Field Type Description
sid String A value you set to identify this conversation session
fm-custom-data String Any ad-hoc values you wish to be sent in any subsequent request from the Platform
fm-workspace String The UneeQ workspace id that this conversation will relate to
Field Type Description
sid String この会話セッションを識別するために設定した値
fm-custom-data String プラットフォームからの後続のリクエストで送信したいアドホック値
fm-workspace String この会話が関連するUneeQワークスペースID


レスポンス形式仕様 | Response format specification

応答は、コンテンツタイプがJSON application/json になります。

Code Status Response
200 OK { "token": SINGLE_USE_TOKEN }
400 Bad Request { "error": ERROR_DESCRIPTION }
401 Unauthorized { "error": ERROR_DESCRIPTION }
403 Forbidden { "error": ERROR_DESCRIPTION }
500 Server Error { "error": ERROR_DESCRIPTION }

 

トークンの値は、Javascript SDK がデジタル ヒューマンとの会話セッションをインスタンス化するために使用することができます。