Skip to main content
GET
クエリ記録一覧を取得

Authorizations

Authorization
string
header
required

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

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

Path Parameters

knowledge_base_id
string<uuid>
required

ナレッジベース ID です。ナレッジベースの API アクセス ダイアログに表示されるサービス API エンドポイントの最後のセグメント(…/knowledge-fs/spaces/<knowledge base ID>)です。アドレスバーでは /datasets/new/ の後のセグメントです。

Query Parameters

cursor
string

前のページの next_cursor から取得したカーソルです。

Required string length: 1 - 1000
source
enum<string>

特定の種類の呼び出し元で生成された記録のみを返します。API キーは service_api、ワークフローノードは workflow、Agent クライアントと MCP クライアントはそれぞれ agent と mcp です。retrieval_test も指定できますが、この API では記録は返されません。

Available options:
retrieval_test,
workflow,
service_api,
agent,
mcp
limit
integer
default:50

1 ページあたりの記録数です。

Required range: 1 <= x <= 100

Response

1 ページ分のクエリ記録です。

data
object[]

クエリ記録です。新しい順に並びます。

next_cursor
string | null

次のページのカーソルです。最後のページでは null です。cursor として送り返してください。