> ## 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 Management APIで、不正ネットワークを対象者ノードとシグナルノードのグラフとして取得します。depthパラメーターで、注目する対象者の周辺範囲を制限できます。



ネットワークグラフAPIのプロンプト
        プロンプトをクリップボードにコピー



      
      

\<pre>

\`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=<uuid> - 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.`

\</pre>



      
      

貼り付け先

ネットワークをグラフとして取得します。グラフには、ネットワーク内の各ベンダーユーザー、ベンダー企業、取引当事者を表すサブジェクトノード、それらを結び付ける共有デバイス、IP、顔、書類番号、電話番号、メールアドレス、住所の各値を表すシグナルノード、そしてそれらの間のメンバーシップを表すエッジが含まれます。`depth`を使うと、`focus_kind`/`focus_id`で指定したサブジェクトから何ホップ先までを返すかを制限できます。これにより、Consoleのグラフビューでは、ネットワーク全体を読み込むのではなく、1人の申請者の直接のつながりにズームインできます。近傍全体を取得するには`depth`を省略する(または`all`を渡す)ことができます。`truncated`は、範囲を制限したリクエストで一部が切り捨てられたかどうかを示します。## 関連ページ- [ネットワークの取得](https://docs.didit.me/ja/management-api/networks/get.md)
- [ネットワークメンバー](https://docs.didit.me/ja/management-api/networks/members.md)
- [ネットワークシグナル](https://docs.didit.me/ja/management-api/networks/signals.md)


## OpenAPI

````yaml ja/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: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID

            // and DIDIT_APPLICATION_ID.

            $didit = new DiditClient();


            $result =
            $didit->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で区別されるサブジェクトノードまたはシグナルノード。サブジェクトノード(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以上はhigh、40以上はmedium、それ以外はlow。
        bar:
          type: number
          format: float
          description: リスクバーの描画に使う0-1の正規化された値。
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API
        keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください:
        https://docs.didit.me/console/api-keys

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.