> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # 欺诈网络图谱 API > 通过 Didit 获取欺诈网络图谱，包含主体和信号节点，并可用深度参数限定焦点主体周围的邻域范围。 网络图谱 API 提示词 将提示词复制到剪贴板 \

\`Retrieve a fraud network as a graph through the Management API.

Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/graph/

Authentication:
Use the x-api-key header with my Didit API key.

Path parameter:
\- network_uuid - the network's UUID.

Query params:
\- depth=1|2|3|all - hops from the focus subject to include. Defaults to all (unbounded).
\- focus_kind=vendor_user|vendor_business|transaction_party - must be supplied together with focus_id.
\- focus_id= - subject UUID to center the graph on.

Response 200: NetworkGraph - { network: NetworkDetail, depth: int|null, truncated: bool, nodes: [...], edges: [...], metrics: {node_count, edge_count, hub_signal_count} }.

Node shapes:
\- Subject node (kind: vendor_user | vendor_business | transaction_party): id, kind, subject, node_status (approved|in_review|declined|not_completed), tags.
\- Signal node (kind: signal): id, kind, uuid, signal_type, subject_count, coverage, is_hub, is_datacenter_ip, is_high_collision_device, node_status (signal_active|signal_guarded), tags, risk_evidence, first_seen_at, last_seen_at.

Edge shape: id, source (subject node id), target (signal node id), subject_kind, signal_type, confidence, observation_count, first_seen_at, last_seen_at.

Failure modes:
\- 404 - network not found or not visible.
\- 400 - depth is not one of 1, 2, 3, all, or focus_kind/focus_id supplied without the other.
\- 401/403 - auth/permission errors.

Side effects: none, pure read.

For the full integration shape, see /integration/integration-prompt.`

\
粘贴到 以图谱形式获取网络：主体节点对应网络中的每个供应商用户、供应商企业或交易方，信号节点对应将它们关联起来的每个共享设备、IP、人脸、证件号码、电话、邮箱或地址值，边则表示它们之间的成员关系。使用 `depth` 限定从 `focus_kind`/`focus_id` 主体向外返回的跳数。控制台的图谱视图正是借助它来放大查看某一申请人的直接关联，而无需加载整个网络。省略 `depth`（或传入 `all`）即可获取完整邻域。`truncated` 会告诉您，有范围限制的请求是否截断了任何内容。## 相关内容- [获取网络](https://docs.didit.me/zh/management-api/networks/get.md) - [网络成员](https://docs.didit.me/zh/management-api/networks/members.md) - [网络信号](https://docs.didit.me/zh/management-api/networks/signals.md) ## OpenAPI ````yaml zh/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/graph/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: 身份证件验证 API。使用 x-api-key 请求头进行身份验证。 servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/graph/: get: tags: - Networks summary: 获取网络图谱 description: >- 将网络作为由主体节点（服务商用户、服务商企业、交易各方）和信号节点（关联它们的共享设备/IP/人脸/证件/电话/邮箱/地址值）组成的图谱进行获取，边表示从属关系。 operationId: get_network_graph parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: 组织 UUID。 - name: application_id in: path required: true schema: type: string format: uuid description: 应用 UUID。 - name: network_uuid in: path required: true schema: type: string format: uuid example: n3a5e000-0000-4000-8000-000000000001 description: 网络 UUID。 - name: depth in: query schema: type: string enum: - '1' - '2' - '3' - all description: 从重点主体开始包含的跳数。默认为全部（无限制）。 - name: focus_kind in: query schema: type: string enum: - vendor_user - vendor_business - transaction_party description: 作为图谱中心的主体类型。必须与 focus_id 一起提供；在深度受限且两者均未提供时，默认为任意成员。 - name: focus_id in: query schema: type: string format: uuid description: 作为图谱中心的主体 UUID。 responses: '200': description: 网络图谱。 content: application/json: schema: $ref: '#/components/schemas/NetworkGraph' '404': description: 未找到网络（或对当前应用不可见）。 content: application/json: schema: type: object properties: detail: type: string security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/graph/?depth=2' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.networks.retrieve_graph( "n3a5e000-0000-4000-8000-000000000001", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); const result = await didit.networks.retrieveGraph("n3a5e000-0000-4000-8000-000000000001"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Networks.RetrieveGraph(ctx, \"n3a5e000-0000-4000-8000-000000000001\", didit.NetworksRetrieveGraphParams{})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.networks().retrieveGraph("n3a5e000-0000-4000-8000-000000000001"); System.out.println(result); - lang: php label: PHP source: >- networks->retrieveGraph('n3a5e000-0000-4000-8000-000000000001'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.networks.retrieve_graph("n3a5e000-0000-4000-8000-000000000001") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); var result = await client.Networks.RetrieveGraphAsync("n3a5e000-0000-4000-8000-000000000001"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: NetworkGraph: type: object properties: network: $ref: '#/components/schemas/NetworkDetail' depth: type: integer nullable: true description: 已应用的有效深度，无限制（depth=all）时为 null。 truncated: type: boolean description: 如果邻域因深度限制而被截断，则为 true。 nodes: type: array items: $ref: '#/components/schemas/NetworkGraphNode' edges: type: array items: $ref: '#/components/schemas/NetworkGraphEdge' metrics: type: object properties: node_count: type: integer edge_count: type: integer hub_signal_count: type: integer NetworkDetail: allOf: - $ref: '#/components/schemas/NetworkListItem' - type: object properties: stats: type: object description: 网络汇总统计信息（例如成员总数）。 fraud_tags: type: array items: type: object description: 在网络上发现的欺诈模式标签。 risk_signals: type: object description: >- 风险信号摘要：residential_proxy_reuse、email_intelligence、phone_intelligence。 reviewed_at: type: string format: date-time nullable: true reviewed_by: type: string nullable: true review_reason: type: string nullable: true properties: notes_count: type: integer minimum: 0 readOnly: true description: 本次调查中分析师私人备注的数量。 NetworkGraphNode: type: object description: >- 主体节点或信号节点，按类型区分。主体节点（kind: vendor_user | vendor_business | transaction_party）包含 id、kind、subject、node_status（approved | in_review | declined | not_completed）和 tags。信号节点（kind: signal）包含 id、kind、uuid、signal_type、subject_count、coverage、is_hub、is_datacenter_ip、is_high_collision_device、node_status（signal_active | signal_guarded）、tags、risk_evidence、first_seen_at 和 last_seen_at。 properties: id: type: string kind: type: string enum: - vendor_user - vendor_business - transaction_party - signal NetworkGraphEdge: type: object properties: id: type: string format: uuid source: type: string description: 主体节点 ID。 target: type: string description: 信号节点 ID。 subject_kind: type: string enum: - vendor_user - vendor_business - transaction_party signal_type: type: string enum: - ip_address - device - face - document_number - phone - email - address confidence: type: number format: float description: 完全匹配为 1.0。 observation_count: type: integer first_seen_at: type: string format: date-time nullable: true last_seen_at: type: string format: date-time nullable: true NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: 易于阅读的组织内顺序 ID，例如 N-0001。 name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- 网络生命周期状态。与网络内每个申请人的 outcome_status（approved/in_review/declined/not_completed）不同。 risk: $ref: '#/components/schemas/NetworkRiskDisplay' pattern_types: type: array items: type: string enum: - exact_same_device - similar_device - same_ip_address - same_address - similar_selfie_backgrounds - similar_poa_documents - same_document_number - same_phone_number - same_email description: 在此网络中检测到的聚集模式。 signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: 此网络中存在的不同信号类型。 member_counts: type: object description: 按类别统计的成员数量（例如总计、按 outcome_status 统计）。 member_status: type: object description: 按 outcome_status 细分的成员明细。 signal_coverage: type: object description: 该网络成员各 signal_type 的覆盖率。 first_activity_at: type: string format: date-time nullable: true last_activity_at: type: string format: date-time nullable: true NetworkRiskDisplay: type: object properties: score: type: integer description: 风险评分，0-100。 band: type: string enum: - low - medium - high description: 分数所属的等级：高等级 >= 70，中等级 >= 40，否则为低等级。 bar: type: number format: float description: 用于渲染风险条的 0-1 归一化值。 securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- 您的应用 API 密钥，可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域：针对每个资源设为无权限、只读或读写，限定于特定工作流或已通过的会话、限定于 IP 地址列表，以及设置到期日期。401 表示密钥错误、已撤销或已过期；403 表示未发送密钥、密钥无权访问该资源或操作，或请求来自其 IP 列表之外的地址；在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null；没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.