Skip to main content
GET
会話変数一覧を取得

承認

Authorization
string
header
必須

すべてのリクエストは API キーで認証します:Authorization: Bearer {API_KEY}。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します(Dify API クイックスタート)。

キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーが欠落または無効なリクエストは HTTP 401(unauthorized)で失敗します。

パスパラメータ

conversation_id
string<uuid>
必須

変数を取得する会話の ID です。会話 ID は 会話一覧を取得 で取得します。

クエリパラメータ

user
string
必須

エンドユーザーの識別子。アプリ側で定義し、アプリ内で一意にします。会話はアプリ、環境、この user の組み合わせに属します。後から読み取りや変更を行うときは、同じ値を送信してください。エンドユーザーの識別 を参照してください。

Required string length: 1 - 255
last_id
string<uuid>

ページネーションカーソルです。現在のページの最後の変数の id を指定します。省略すると最初のページを取得します。

limit
integer
デフォルト:20

返すレコード数です。

必須範囲: 1 <= x <= 100
variable_name
string

名前にこの文字列を含む変数だけを返します。大文字と小文字は区別しません。

Required string length: 1 - 255

レスポンス

この会話の変数の 1 ページ分です。作成が古い順に並びます。

limit
integer

このページに適用されたページサイズです。

has_more
boolean

次のページがあるかどうかです。

data
object[]

会話変数です。作成日時の古い順に並びます。