Список сетей мошенников API

curl

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/?status=active,in_review&ordering=-risk_score' \
  -H 'x-api-key: YOUR_API_KEY'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();

for await (const item of didit.networks.list()) {
  console.log(item);
}

ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()

iter := client.Networks.ListAutoPaging(ctx, didit.NetworksListParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

import me.didit.Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();

for (var item : client.networks().list()) {
    System.out.println(item);
}

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();

foreach ($didit->networks->list() as $item) {
    print_r($item->toArray());
}

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();

await foreach (var item in await client.Networks.ListAsync())
{
    Console.WriteLine(JsonSerializer.Serialize(item));
}

{
  "count": 123,
  "next": 123,
  "previous": 123,
  "results": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "network_id": "<string>",
      "name": "<string>",
      "status": "active",
      "risk": {
        "score": 123,
        "band": "low",
        "bar": 123
      },
      "pattern_types": [
        "exact_same_device"
      ],
      "signal_types": [
        "ip_address"
      ],
      "member_counts": {},
      "member_status": {},
      "signal_coverage": {},
      "first_activity_at": "2023-11-07T05:31:56Z",
      "last_activity_at": "2023-11-07T05:31:56Z"
    }
  ],
  "sharing_mode": "global",
  "cross_org_available": true,
  "cross_org_unavailable_reason": null,
  "kpis": {
    "active": {},
    "in_review": {},
    "applicants_involved": {},
    "detected_this_period": {},
    "false_positive_rate": {}
  },
  "counts": {
    "scopes": {
      "all": 123,
      "identity": 123,
      "transactions": 123
    },
    "views": {
      "all": 123,
      "active": 123,
      "in_review": 123,
      "resolved": 123,
      "dismissed": 123,
      "mine": 123,
      "high_risk": 123
    },
    "facets": {
      "total": 123,
      "last_activity_days": {
        "7": 123,
        "30": 123,
        "90": 123
      },
      "risk_min": {
        "50": 123,
        "80": 123
      },
      "signal_types": {
        "ip_address": 123,
        "device": 123,
        "face": 123,
        "document_number": 123,
        "phone": 123,
        "email": 123,
        "address": 123
      },
      "priority": {
        "low": 123,
        "medium": 123,
        "high": 123,
        "none": 123
      },
      "assignee": {
        "me": 123,
        "unassigned": 123,
        "users": [
          {
            "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "full_name": "<string>",
            "email": "<string>",
            "count": 123
          }
        ]
      },
      "has_case": 123,
      "min_size": {
        "10": 123
      }
    }
  }
}

GET

organization

{organization_id}

application

{application_id}

networks

curl

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/?status=active,in_review&ordering=-risk_score' \
  -H 'x-api-key: YOUR_API_KEY'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();

for await (const item of didit.networks.list()) {
  console.log(item);
}

ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()

iter := client.Networks.ListAutoPaging(ctx, didit.NetworksListParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

import me.didit.Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();

for (var item : client.networks().list()) {
    System.out.println(item);
}

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();

foreach ($didit->networks->list() as $item) {
    print_r($item->toArray());
}

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();

await foreach (var item in await client.Networks.ListAsync())
{
    Console.WriteLine(JsonSerializer.Serialize(item));
}

{
  "count": 123,
  "next": 123,
  "previous": 123,
  "results": [
    {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "network_id": "<string>",
      "name": "<string>",
      "status": "active",
      "risk": {
        "score": 123,
        "band": "low",
        "bar": 123
      },
      "pattern_types": [
        "exact_same_device"
      ],
      "signal_types": [
        "ip_address"
      ],
      "member_counts": {},
      "member_status": {},
      "signal_coverage": {},
      "first_activity_at": "2023-11-07T05:31:56Z",
      "last_activity_at": "2023-11-07T05:31:56Z"
    }
  ],
  "sharing_mode": "global",
  "cross_org_available": true,
  "cross_org_unavailable_reason": null,
  "kpis": {
    "active": {},
    "in_review": {},
    "applicants_involved": {},
    "detected_this_period": {},
    "false_positive_rate": {}
  },
  "counts": {
    "scopes": {
      "all": 123,
      "identity": 123,
      "transactions": 123
    },
    "views": {
      "all": 123,
      "active": 123,
      "in_review": 123,
      "resolved": 123,
      "dismissed": 123,
      "mine": 123,
      "high_risk": 123
    },
    "facets": {
      "total": 123,
      "last_activity_days": {
        "7": 123,
        "30": 123,
        "90": 123
      },
      "risk_min": {
        "50": 123,
        "80": 123
      },
      "signal_types": {
        "ip_address": 123,
        "device": 123,
        "face": 123,
        "document_number": 123,
        "phone": 123,
        "email": 123,
        "address": 123
      },
      "priority": {
        "low": 123,
        "medium": 123,
        "high": 123,
        "none": 123
      },
      "assignee": {
        "me": 123,
        "unassigned": 123,
        "users": [
          {
            "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "full_name": "<string>",
            "email": "<string>",
            "count": 123
          }
        ]
      },
      "has_case": 123,
      "min_size": {
        "10": 123
      }
    }
  }
}

Перечислите сети мошенничества, обнаруженные для вашей организации. По умолчанию список упорядочен по оценке риска: сначала самые высокие, затем по времени последней активности. Каждый фильтр, доступный в списке Networks в консоли, передаётся как параметр запроса, включая поиск по свободному тексту q и те же чипы статуса, сигнала, паттерна и диапазона риска. Параметры assignee, priority, risk_min и has_case соответствуют опциям «исполнитель», «приоритет», «минимальный риск» и «связанный кейс», которые учитывает counts.facets. assignee=me требует токен участника консоли; при использовании API-ключа возвращается 400.

В приложениях в песочнице сетей никогда не бывает. Кластеризация выполняется только на продакшн-данных.

Режим обмена и сигналы между организациями

Каждый ответ содержит sharing_mode, cross_org_available и cross_org_unavailable_reason вашей организации.

Поле	Значение
`sharing_mode`	Режим обмена данными между организациями. Только `global` сравнивает сети между организациями; `private` и `off` оставляют сети только в истории самой организации.
`cross_org_available`	Применяются ли к вашей организации сигналы между организациями. Для этого нужны и тариф Enterprise, и режим `global`.
`cross_org_unavailable_reason`	`plan`, если ваш тариф не включает сеть мошенничества между организациями (нужен тариф Enterprise), независимо от режима обмена. `sharing_mode`, если тариф это включает, но ваш режим обмена `private` или `off`. `null`, если `cross_org_available` равно `true`.

Тариф проверяется первым: если тариф ниже Enterprise, причина будет plan, даже когда режим обмена global.

Счётчики и параметр summary

kpis агрегирует сети, которые соответствуют вашим фильтрам, а counts агрегирует все сети, которые видит ваше приложение, поэтому оба показателя требуют больше ресурсов, чем сама страница. Передайте summary=false, если нужны только страница и её count: тогда ответ не содержит kpis и counts. summary принимает только true или false; любое другое значение возвращает 400. counts содержит числа, на которых основаны представления списка и опции фильтров; каждая сеть учитывается один раз:

Ключ	Что считает
`scopes`	Каждую видимую сеть (`all`), разделённую на `transactions` (все участники являются сторонами транзакции) и `identity` (все остальные сети).
`views`	Видимые сети в выбранном `scope` (`all`) по статусу (`active`, `in_review`, `resolved`, `dismissed`), назначенные участнику консоли, выполняющему вызов (`mine`), и `high_risk` (оценка риска 80 и выше, не отклонённые).
`facets`	Сети в выбранной области (`scope`) и представлении по `status` (`total`), по времени последней активности (`last_activity_days`: 7, 30, 90), по минимальному риску (`risk_min`: 50, 80), по типу сигнала, по приоритету (включая `none`), по исполнителю (`me`, `unassigned` и по одной записи для каждого исполнителя в `users`), сети, для которых ваше приложение открыло кейс (`has_case`), и сети с не менее чем 10 участниками (`min_size`).

Фильтры, отличные от scope и status, не меняют counts. views.mine и facets.assignee.me всегда равны 0 для API-ключа, поскольку участник консоли в этом случае не выполняет вызов.

Доступ

Endpoint’ам Networks нужен API-ключ с полным доступом. Ключ с ограниченным доступом получает 403. Токену участника консоли нужно разрешение list:networks. Если Networks не включён для вашей организации, каждый endpoint Networks возвращает 403 с "code": "networks_not_entitled".

Связанное

Авторизации

x-api-key

string

header

обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

Параметры пути

organization_id

string<uuid>

обязательно

UUID организации.

application_id

string<uuid>

обязательно

UUID приложения.

Параметры запроса

status

string

Разделённый запятыми список статусов для включения: active,in_review,resolved,dismissed. Опустите, чтобы исключить dismissed.

scope

enum<string>

transactions оставляет сети, все участники которых являются сторонами транзакции; identity оставляет все остальные сети. Опустите для обеих. Это также сужает counts.views и counts.facets. Любое другое значение возвращает 400.

Доступные опции:

identity,

transactions

signal_type

string

Разделённый запятыми список типов сигналов: ip_address,device,face,document_number,phone,email,address.

pattern_type

string

Разделённый запятыми список типов шаблонов, например exact_same_device,same_email.

risk_band

string

Разделённые запятыми диапазоны: low,medium,high.

min_size

integer

Минимальное количество участников.

max_size

integer

Максимальное количество участников.

assignee

string

Разделённые запятыми ответственные лица: unassigned, email участников (без учёта регистра) или me для вызывающего участника консоли. Сеть совпадает с любым значением. Для me требуется token участника консоли: API-ключ вернёт ошибку 400 {"assignee": ["\"me\" needs a user token; an API key has no assignee identity."]}.

priority

string

Разделённые запятыми приоритеты: low, medium, high или none для сетей без приоритета. Любое другое значение возвращает 400 {"priority": "Unknown priority: <values>."}.

risk_min

integer

Минимальная оценка риска, целое число от 0 до 100. Нецелое число возвращает 400 {"risk_min": "Use a whole number from 0 to 100."}.

Требуемый диапазон: 0 <= x <= 100

has_case

boolean

true оставляет сети, по которым ваше приложение открыло кейс, а false оставляет остальные. Любое другое значение игнорируется.

date_from

string<date>

Нижняя граница для last_activity_at (дата или дата и время по стандарту ISO 8601).

date_to

string<date>

Верхняя граница first_activity_at (дата или дата и время в формате ISO 8601).

string

Полнотекстовый поиск по названию сети, именам участников, network_id (N-0001) и точным токенам pattern_type.

ordering

string

Одно из значений: risk_score, -risk_score, last_activity_at, -last_activity_at, first_activity_at, -first_activity_at, network_number, -network_number. По умолчанию: -risk_score,-last_activity_at.

limit

integer

по умолчанию:100

Размер страницы, 1–500. По умолчанию 100.

Требуемый диапазон: 1 <= x <= 500

offset

integer

по умолчанию:0

Смещение первой записи, начиная с нуля.

Требуемый диапазон: x >= 0

summary

boolean

по умолчанию:true

false возвращает только страницу и её count, без kpis и counts. По умолчанию true. Любое значение, кроме true или false, возвращает 400.

Ответ

Список сетей с пагинацией, с режимом общего доступа организации и доступностью между организациями, а также с kpis и counts, если не указано summary=false.

count

integer

обязательно

integer | null

обязательно

Смещение следующей страницы или null на последней странице.

integer | null

обязательно

results

object[]

обязательно

Show child attributes

Режим межорганизационного обмена данными организации. Только global сравнивает сети между организациями; private и off оставляют их только в истории этой организации.

Доступные опции:

off,

private,

global

Пример:

"global"

cross_org_available

boolean

обязательно

Применяются ли сигналы между организациями к этой организации. Для них требуются как тариф Enterprise, так и режим общего доступа global.

Пример:

true

cross_org_unavailable_reason

enum<string> | null

обязательно

Причина, по которой межорганизационные сигналы не применяются; проверяются в следующем порядке. plan: тариф организации не включает межорганизационную сеть защиты от мошенничества (требуется тариф Enterprise) независимо от режима обмена данными. sharing_mode: тариф включает её, но режим обмена установлен как private или off. Null, если cross_org_available равен true.

Доступные опции:

plan,

sharing_mode

Пример:

null

kpis

object

Каждый ключ представляет собой {value, delta} по результатам, соответствующим текущим фильтрам. Опускается при summary=false.

Show child attributes

counts

object

Количество сетей для представлений списка и параметров фильтрации; каждая сеть учитывается один раз. Возвращается, только если summary не равно false. scopes подсчитывает все сети, видимые приложению. views подсчитывает видимые сети внутри выбранного scope. facets подсчитывает сети в выбранном scope и представлении status (отклонённые сети исключаются, если status не включает их). Другие фильтры списка не влияют на эти подсчёты.

Show child attributes

Последнее изменение 7 ноября 2026 г.

​Режим обмена и сигналы между организациями

​Счётчики и параметр summary

​Доступ

​Связанное

Авторизации

Параметры пути

Параметры запроса

Ответ

Режим обмена и сигналы между организациями

Счётчики и параметр summary

Доступ

Связанное