API para listar redes de fraude

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
      }
    }
  }
}

Liste as redes de fraude detectadas para sua organização. Por padrão, a lista é ordenada pela pontuação de risco, da maior para a menor, e depois pela atividade mais recente. Todos os filtros disponíveis na lista de Redes do Console são expostos como parâmetros de consulta, incluindo a busca de texto livre q e os mesmos chips de status, sinal, padrão e faixa de risco. Os parâmetros assignee, priority, risk_min e has_case correspondem às opções de responsável, prioridade, risco mínimo e caso vinculado que counts.facets contabiliza. assignee=me exige um token de membro do Console; com uma chave de API, retorna 400.

Aplicações de sandbox nunca têm redes. O agrupamento é executado apenas com dados de produção.

Modo de compartilhamento e sinais entre organizações

Toda resposta inclui sharing_mode, cross_org_available e cross_org_unavailable_reason da sua organização.

Campo	Significado
`sharing_mode`	O modo de compartilhamento entre organizações da sua organização. Apenas `global` compara redes entre organizações; `private` e `off` as restringem ao próprio histórico da organização.
`cross_org_available`	Indica se os sinais entre organizações se aplicam à sua organização. Eles exigem o plano Enterprise e o modo de compartilhamento `global`.
`cross_org_unavailable_reason`	`plan` quando seu plano não inclui a rede de fraude entre organizações (ela exige o plano Enterprise), qualquer que seja seu modo de compartilhamento. `sharing_mode` quando o plano a inclui, mas seu modo de compartilhamento é `private` ou `off`. `null` quando `cross_org_available` é `true`.

O plano é verificado primeiro: abaixo do plano Enterprise, o motivo é plan mesmo quando seu modo de compartilhamento é global.

Contagens e o parâmetro summary

kpis agregam as redes que correspondem aos seus filtros e counts agregam todas as redes que sua aplicação pode ver, por isso ambos custam mais do que a própria página. Passe summary=false quando precisar apenas da página e do seu count: a resposta então omite kpis e counts. summary aceita apenas true ou false; qualquer outro valor retorna 400. counts contém os números por trás das visualizações e opções de filtro da lista, com cada rede contada uma única vez:

Chave	O que contabiliza
`scopes`	Todas as redes visíveis (`all`), divididas em `transactions` (todo membro é parte de uma transação) e `identity` (todas as outras redes).
`views`	Redes visíveis dentro do `scope` selecionado (`all`), por status (`active`, `in_review`, `resolved`, `dismissed`), atribuídas ao membro do console que chama (`mine`) e `high_risk` (pontuação de risco de 80 ou mais, não descartadas).
`facets`	Redes no `scope` e na visualização de `status` selecionados (`total`), por atividade recente (`last_activity_days`: 7, 30, 90), risco mínimo (`risk_min`: 50, 80), tipo de sinal, prioridade (incluindo `none`), responsável (`me`, `unassigned` e uma entrada por responsável em `users`), redes para as quais sua aplicação abriu um caso (`has_case`) e redes com pelo menos 10 membros (`min_size`).

Filtros diferentes de scope e status não alteram counts. views.mine e facets.assignee.me são sempre 0 para uma chave de API, já que nenhum membro do console está chamando a API.

Acesso

Os endpoints de Redes exigem uma chave de API com acesso total. O uso de uma chave com acesso restrito resulta em 403. Um token de membro do console precisa de list:networks. Quando Networks não está habilitado para sua organização, todos os endpoints de Redes retornam 403 com "code": "networks_not_entitled".

Relacionados

Autorizações

x-api-key

string

header

obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

organization_id

string<uuid>

obrigatório

UUID da organização.

application_id

string<uuid>

obrigatório

UUID da aplicação.

Parâmetros de consulta

status

string

Status a incluir, separados por vírgula: active,in_review,resolved,dismissed. Omita para excluir dismissed.

scope

enum<string>

transactions mantém as redes cujos membros são todos partes de transações; identity mantém todas as outras redes. Omita para obter ambas. Também restringe counts.views e counts.facets. Qualquer outro valor retorna 400.

Opções disponíveis:

identity,

transactions

signal_type

string

Tipos de sinal separados por vírgula: ip_address,device,face,document_number,phone,email,address.

pattern_type

string

Tipos de padrão separados por vírgula, por exemplo, exact_same_device,same_email.

risk_band

string

Faixas separadas por vírgula: low,medium,high.

min_size

integer

Quantidade mínima de membros.

max_size

integer

Número máximo de membros.

assignee

string

Responsáveis separados por vírgula: unassigned, e-mails de membros (comparados sem diferenciar maiúsculas de minúsculas) ou me para o membro do console que faz a chamada. Uma rede corresponde a qualquer valor. me exige um token de membro do console: uma chave de API recebe 400 {"assignee": ["\"me\" needs a user token; an API key has no assignee identity."]}.

priority

string

Prioridades separadas por vírgula: low, medium, high ou none para redes sem prioridade. Qualquer outro valor retorna 400 {"priority": "Unknown priority: <values>."}.

risk_min

integer

Pontuação de risco mínima, um número inteiro de 0 a 100. Um valor que não seja um número inteiro retorna 400 {"risk_min": "Use a whole number from 0 to 100."}.

Intervalo obrigatório: 0 <= x <= 100

has_case

boolean

true mantém as redes para as quais sua aplicação abriu um caso, e false, as demais. Qualquer outro valor é ignorado.

date_from

string<date>

Limite inferior de last_activity_at (data ou data e hora ISO 8601).

date_to

string<date>

Limite superior de first_activity_at (data ou data e hora ISO 8601).

string

Busca em texto livre por nome da rede, nomes dos membros, network_id (N-0001) e tokens exatos de pattern_type.

ordering

string

Um entre risk_score, -risk_score, last_activity_at, -last_activity_at, first_activity_at, -first_activity_at, network_number, -network_number. O padrão é -risk_score,-last_activity_at.

limit

integer

padrão:100

Tamanho da página, de 1 a 500. O padrão é 100.

Intervalo obrigatório: 1 <= x <= 500

offset

integer

padrão:0

Deslocamento, a partir de zero, do primeiro registro.

Intervalo obrigatório: x >= 0

summary

boolean

padrão:true

false retorna a página e seu count apenas, sem kpis e counts. O padrão é true. Qualquer valor diferente de true ou false retorna 400.

Resposta

Lista paginada de redes, com o modo de compartilhamento da organização e a disponibilidade entre organizações, além de kpis e counts, exceto quando summary=false.

count

integer

obrigatório

integer | null

obrigatório

Offset da próxima página, ou null na última página.

integer | null

obrigatório

results

object[]

obrigatório

Show child attributes

O modo de compartilhamento entre organizações da organização. Somente global compara redes entre organizações; private e off as restringem ao histórico da própria organização.

Opções disponíveis:

off,

private,

global

Exemplo:

"global"

cross_org_available

boolean

obrigatório

Indica se os sinais entre organizações se aplicam a esta organização. Eles exigem tanto o plano Enterprise quanto o modo de compartilhamento global.

Exemplo:

true

cross_org_unavailable_reason

enum<string> | null

obrigatório

Por que os sinais entre organizações não se aplicam, verificados nesta ordem. plan: o plano da organização não inclui a rede antifraude entre organizações (ela exige o plano Enterprise), qualquer que seja o modo de compartilhamento. sharing_mode: o plano a inclui, mas o modo de compartilhamento é private ou off. Nulo quando cross_org_available é true.

Opções disponíveis:

plan,

sharing_mode

Exemplo:

null

kpis

object

Cada chave é {value, delta} sobre os resultados que correspondem aos filtros atuais. Omitido quando summary=false.

Show child attributes

counts

object

Contagens de redes para as visualizações e opções de filtro da lista, com cada rede contada uma única vez. Retornado somente quando summary não é false. scopes contam todas as redes visíveis para a aplicação. views contam as redes visíveis dentro do scope selecionado. facets contam as redes no scope e na visualização de status selecionados (redes descartadas ficam de fora, a menos que status as inclua). Os demais filtros da lista não alteram essas contagens.

Show child attributes

Última modificação em 1 de novembro de 2026

​Modo de compartilhamento e sinais entre organizações

​Contagens e o parâmetro summary

​Acesso

​Relacionados

Autorizações

Parâmetros de caminho

Parâmetros de consulta

Resposta

Modo de compartilhamento e sinais entre organizações

Contagens e o parâmetro summary

Acesso

Relacionados