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

​
エッジ一覧取得

指定したエンティティ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レート制限超過