エッジ一覧取得

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

リクエスト

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

ヘッダー

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

クエリパラメータ

パラメータ	型	必須	説明
`entityIds`	`string`	はい	エンティティIDのカンマ区切り（1〜100個）
`type`	`string`	いいえ	リレーションタイプでフィルタ

レスポンス

{
  "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"
    }
  ]
}

レスポンスフィールド

フィールド	型	説明
`edges`	`object[]`	エッジ配列（weight降順）
`edges[].id`	`string`	エッジ ID
`edges[].sourceEntityId`	`string`	始点エンティティ ID
`edges[].targetEntityId`	`string`	終点エンティティ ID
`edges[].type`	`string`	リレーションタイプ
`edges[].weight`	`number`	重みスコア
`edges[].createdAt`	`string`	作成日時
`edges[].updatedAt`	`string`	更新日時

使用例

# 指定エンティティに接続するエッジを取得
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"

import requests

resp = requests.get(
    "https://app.snorbe.deskrex.ai/api/v1/graph/edges",
    params={"entityIds": "claaa001,clbbb001"},
    headers={"Authorization": "Bearer snorbe_your_api_key_here"},
)
data = resp.json()
for edge in data["edges"]:
    print(f"{edge['sourceEntityId']} --[{edge['type']}]--> {edge['targetEntityId']} (w={edge['weight']})")

const params = new URLSearchParams({ entityIds: "claaa001,clbbb001" });
const resp = await fetch(
  `https://app.snorbe.deskrex.ai/api/v1/graph/edges?${params}`,
  { headers: { Authorization: "Bearer snorbe_your_api_key_here" } },
);
const data = await resp.json();
for (const edge of data.edges) {
  console.log(`${edge.sourceEntityId} --[${edge.type}]--> ${edge.targetEntityId} (w=${edge.weight})`);
}

エラーレスポンス

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