メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.snorbe.deskrex.ai/llms.txt

Use this file to discover all available pages before exploring further.

エッジ一覧取得

指定したエンティティIDに接続するエッジ(リレーションシップ)を返します。/graph/entities で取得したIDを指定してください。

リクエスト

GET /api/v1/graph/edges?entityIds=id1,id2,id3

ヘッダー

ヘッダー必須説明
AuthorizationはいBearer snorbe_... 形式の API キー

クエリパラメータ

パラメータ必須説明
entityIdsstringはいエンティティIDのカンマ区切り(1〜100個)
typestringいいえリレーションタイプでフィルタ

レスポンス

{
  "edges": [
    {
      "id": "clxxx001",
      "sourceEntityId": "claaa001",
      "targetEntityId": "clbbb001",
      "type": "RELATED_TO",
      "weight": 0.85,
      "createdAt": "2026-01-15T10:30:00.000Z",
      "updatedAt": "2026-03-20T14:22:00.000Z"
    }
  ]
}

レスポンスフィールド

フィールド説明
edgesobject[]エッジ配列(weight降順)
edges[].idstringエッジ ID
edges[].sourceEntityIdstring始点エンティティ ID
edges[].targetEntityIdstring終点エンティティ ID
edges[].typestringリレーションタイプ
edges[].weightnumber重みスコア
edges[].createdAtstring作成日時
edges[].updatedAtstring更新日時

使用例

# 指定エンティティに接続するエッジを取得
curl "https://app.snorbe.deskrex.ai/api/v1/graph/edges?entityIds=claaa001,clbbb001" \
  -H "Authorization: Bearer snorbe_your_api_key_here"

# リレーションタイプでフィルタ
curl "https://app.snorbe.deskrex.ai/api/v1/graph/edges?entityIds=claaa001&type=RELATED_TO" \
  -H "Authorization: Bearer snorbe_your_api_key_here"

エラーレスポンス

HTTP ステータスコード説明
400BAD_REQUESTentityIds が空、または101個以上指定されている
401UNAUTHORIZEDAPI キーが無効、期限切れ、または未指定
429TOO_MANY_REQUESTSレート制限超過