会話を取得

現在のユーザーの会話リストを取得し、デフォルトで最新の20件を返します。

GET /conversations

Error

A valid request URL is required to generate request examples

200

{
  "limit": 123,
  "has_more": true,
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "inputs": {},
      "status": "<string>",
      "introduction": "<string>",
      "created_at": 123,
      "updated_at": 123
    }
  ]
}

承認

Authorization · string · header · 必須

APIキー認証。すべてのAPIリクエストにおいて、Authorization HTTPヘッダーにAPIキーを含めてください。形式：Bearer {API_KEY}。APIキーの漏洩を防ぐため、APIキーはクライアント側で共有または保存せず、サーバー側で保存することを強くお勧めします。

クエリパラメータ

user · string · 必須

ユーザー識別子。アプリケーション内で開発者によって一意に定義される必要があります。重要な注意事項: Service API は WebApp で作成された対話を共有しません。API を通じて作成された対話は、WebApp インターフェースで作成されたものとは分離されています。

last_id · string<uuid> | null

(Optional)現在のページの最後のレコードのID、デフォルトはnullです。

limit · integer · デフォルト: 20

1回のリクエストで返すレコードの数、デフォルトは20件です。最大100、最小1。

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

sort_by · enum<string> · デフォルト: -updated_at

(Optional)ソートフィールド、デフォルト：-updated_at（更新時間で降順にソート）。利用可能な値：created_at, -created_at, updated_at, -updated_at。フィールドの前の記号「-」は逆順を表します。

利用可能なオプション: created_at, -created_at, updated_at, -updated_at

レスポンス

200 - application/json

会話リストを正常に取得しました。

limit · integer

返されたエントリの数。

has_more · boolean

data · object[]

会話のリスト。

表示 子属性