> ## 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 per elencare le reti di frode
> Didit: elenca le reti di frode rilevate, filtrate per stato, segnale, pattern, rischio, dimensione e data, con modalità di condivisione.
List Networks API Prompt
Copia il prompt negli appunti
\
\`List fraud networks for my Didit application through the Management API.
Endpoint:
GET https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/
Authentication:
Use the x-api-key header with my Didit API key.
Networks endpoints need a full-access API key: a key with restricted access gets 403.
Goal:
\- Retrieve the same clustered fraud networks the Console's Networks list shows: applicants, businesses, or transaction parties linked by shared device, IP, face, document number, phone, email, or address signals, within my own organization only.
Useful query params:
\- status=active,in_review,resolved,dismissed (comma-separated). Omit to exclude dismissed networks.
\- scope=identity|transactions: transactions keeps networks whose members are all transaction parties, identity keeps every other network. Omit for both. Any other value is a 400.
\- signal_type=ip_address,device,face,document_number,phone,email,address (comma-separated)
\- pattern_type=exact_same_device,similar_device,same_ip_address,same_address,similar_selfie_backgrounds,similar_poa_documents,same_document_number,same_phone_number,same_email (comma-separated)
\- risk_band=low,medium,high (comma-separated)
\- min_size, max_size - member count bounds
\- assignee=unassigned,,me (comma-separated, any value matches). me needs a console member token; an API key gets a 400.
\- priority=low,medium,high,none (comma-separated; none is a network without a priority). Any other value is a 400.
\- risk_min - minimum risk score, a whole number from 0 to 100. A value that is not a whole number is a 400.
\- has_case=true|false - networks your application opened a case for, or the others
\- date_from, date_to - ISO 8601 date/datetime bounds on activity
\- q - free-text search across network name, member names, and the network id (e.g. N-0001)
\- ordering=risk_score|-risk_score|last_activity_at|-last_activity_at|first_activity_at|-first_activity_at|network_number|-network_number (default -risk_score,-last_activity_at)
\- limit (1-500, default 100), offset
\- summary=true|false: false returns the page and its count only, without kpis and counts. Defaults to true. Any other value is a 400.
Example call:
curl -X GET "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/?status=active,in_review&ordering=-risk_score" \
-H "x-api-key: YOUR_API_KEY"
Response shape:
\{"count": int, "next": int|null, "previous": int|null, "results": [NetworkListItem, ...], "kpis": {...}, "counts": {...}, "sharing_mode": "off"|"private"|"global", "cross_org_available": bool, "cross_org_unavailable_reason": "plan"|"sharing_mode"|null}
next/previous are offsets, not URLs - null next means the last page.
Each NetworkListItem has uuid, network_id (e.g. "N-0001"), name, status (active|in_review|resolved|dismissed), risk {score, band, bar}, pattern_types, signal_types, member_counts, member_status, signal_coverage, first_activity_at, last_activity_at.
kpis carries active, in_review, applicants_involved, detected_this_period, false_positive_rate, each as {value, delta}, computed over the filtered result set.
counts carries scopes {all, identity, transactions}, views {all, active, in_review, resolved, dismissed, mine, high_risk} and facets {total, last_activity_days {"7", "30", "90"}, risk_min {"50", "80"}, signal_types {one count per signal type}, priority {low, medium, high, none}, assignee {me, unassigned, users: [{uuid, full_name, email, count}]}, has_case, min_size {"10"}}.
scopes count every network visible to this application; views count the visible networks inside the selected scope; facets count the networks in the selected scope and status view. The other filters do not change counts. mine and assignee.me are always 0 for an API key.
kpis and counts are omitted when summary=false.
Cross-organization fields (on every response, whatever summary says):
\- sharing_mode: the organization's cross-organization sharing mode. Only global compares networks across organizations; private and off keep them to the organization's own history.
\- cross_org_available: whether cross-organization signals apply to this organization. They need the Enterprise plan and the global sharing mode.
\- cross_org_unavailable_reason: plan (the organization's plan does not include the cross-organization fraud network; it needs the Enterprise plan, whatever the sharing mode), sharing_mode (the plan includes it, but sharing is private or off), or null when cross_org_available is true. plan is checked first.
Notes:
\- Sandbox applications never return networks - clustering excludes sandbox data entirely.
\- Networks are clustered organization-wide, but this endpoint only returns networks with at least one member visible to this application.
Failure modes:
\- 401: missing or invalid x-api-key. {"detail": "Authentication credentials were not provided or are invalid."}
\- 403: the API key belongs to another application, or it has restricted access (Networks needs a full-access key). A console member token needs list:networks. {"detail": "You do not have permission to perform this action."} or {"detail": "This API key has no access to this endpoint."}
\- 403 with code: Networks is not enabled for the organization. {"detail": "Networks is disabled for this organization. Contact Didit support if you believe this is an error.", "code": "networks_not_entitled"}
\- 400: an invalid filter, ordering, limit or offset, or summary that is not true or false. {"summary": ["Must be \\"true\\" or \\"false\\"."]}
Side effects: none, pure read.
For the full integration shape, see /integration/integration-prompt.`
\
Incolla in
Elenca le reti di frode rilevate per la tua organizzazione.
Per impostazione predefinita, l'elenco è ordinato per punteggio di rischio, dal più alto al più basso, e poi per attività più recente.
Ogni filtro disponibile nell'elenco Networks della Console è esposto come parametro di query, inclusa la ricerca testuale `q` e gli stessi chip di stato, segnale, pattern e fascia di rischio.
I parametri `assignee`, `priority`, `risk_min` e `has_case` corrispondono alle opzioni di assegnatario, priorità, rischio minimo e caso collegato che `counts.facets` conteggia.
`assignee=me` richiede un token di un membro della console; con una chiave API restituisce `400`.> [!NOTE]
>
> Le applicazioni sandbox non hanno mai reti. Il clustering viene eseguito solo sui dati di produzione.## Modalità di condivisione e segnali tra organizzazioniOgni risposta include `sharing_mode`, `cross_org_available` e `cross_org_unavailable_reason` della tua organizzazione.| Campo | Significato |
| - | - |
| `sharing_mode` | La modalità di condivisione tra organizzazioni della tua organizzazione. Solo `global` confronta le reti tra organizzazioni; `private` e `off` limitano le reti alla cronologia della sola organizzazione. |
| `cross_org_available` | Indica se i segnali tra organizzazioni si applicano alla tua organizzazione. Richiedono sia il piano Enterprise sia la modalità di condivisione `global`. |
| `cross_org_unavailable_reason` | `plan` quando il tuo piano non include la rete di frode tra organizzazioni (richiede il piano Enterprise), qualunque sia la tua modalità di condivisione. `sharing_mode` quando il piano la include ma la tua modalità di condivisione è `private` o `off`. `null` quando `cross_org_available` è `true`. |Il piano viene verificato per primo: al di sotto del piano Enterprise, il motivo è `plan` anche quando la tua modalità di condivisione è `global`.## Conteggi e parametro summary`kpis` aggrega le reti che corrispondono ai tuoi filtri, mentre `counts` aggrega ogni rete visibile alla tua applicazione; entrambi costano più della sola pagina.
Passa `summary=false` quando ti serve solo la pagina e il suo `count`: in tal caso la risposta omette `kpis` e `counts`.
`summary` accetta solo `true` o `false`; qualsiasi altro valore restituisce `400`.`counts` contiene i numeri alla base delle viste dell'elenco e delle opzioni di filtro, con ogni rete conteggiata una sola volta:| Chiave | Cosa conta |
| - | - |
| `scopes` | Ogni rete visibile (`all`), suddivisa in `transactions` (ogni membro è una parte di una transazione) e `identity` (ogni altra rete). |
| `views` | Reti visibili all'interno dello `scope` selezionato (`all`), per stato (`active`, `in_review`, `resolved`, `dismissed`), assegnate al membro della console che effettua la chiamata (`mine`), e `high_risk` (punteggio di rischio pari o superiore a 80, non dismissate). |
| `facets` | Reti nello `scope` e nella vista di `status` selezionati (`total`), per attività recente (`last_activity_days`: 7, 30, 90), rischio minimo (`risk_min`: 50, 80), tipo di segnale, priorità (incluso `none`), assegnatario (`me`, `unassigned` e una voce per ogni assegnatario in `users`), reti per cui la tua applicazione ha aperto un caso (`has_case`), e reti con almeno 10 membri (`min_size`). |I filtri diversi da `scope` e `status` non modificano `counts`.
`views.mine` e `facets.assignee.me` sono sempre `0` per una chiave API, perché nessun membro della console sta effettuando la chiamata.## AccessoGli endpoint delle reti richiedono una [chiave API](https://docs.didit.me/it/console/api-keys.md) con accesso completo.
Una chiave con accesso limitato riceve `403`.
Un token di un membro della console richiede `list:networks`.
Quando Networks non è abilitato per la tua organizzazione, ogni endpoint delle reti restituisce `403` con `"code": "networks_not_entitled"`.## Correlati- [Ottieni rete](https://docs.didit.me/it/management-api/networks/get.md)
- [Grafo della rete](https://docs.didit.me/it/management-api/networks/graph.md)
- [Networks (Console)](https://docs.didit.me/it/console/networks.md)
## OpenAPI
````yaml it/openapi-25.json GET /v3/organization/{organization_id}/application/{application_id}/networks/
openapi: 3.0.0
info:
version: 3.0.0
title: Didit Verification API
description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key.
servers:
- url: https://verification.didit.me
security: []
tags: []
paths:
/v3/organization/{organization_id}/application/{application_id}/networks/:
get:
tags:
- Networks
summary: Elenca le reti
description: >-
Elenca le reti di frode rilevate all'interno dell'organizzazione di
questa applicazione, con il rischio più elevato per primo come
impostazione predefinita. Per impostazione predefinita le reti ignorate
sono escluse; passa status per includerle. Le applicazioni sandbox non
hanno mai reti: il clustering esclude completamente i dati sandbox. Ogni
risposta include lo `sharing_mode` dell'organizzazione e se i segnali
tra organizzazioni diverse si applicano ad essa (`cross_org_available`,
`cross_org_unavailable_reason`). `kpis` aggrega le reti che
corrispondono ai tuoi filtri e `counts` aggrega ogni rete che
l'applicazione può vedere; passa `summary=false` per saltare entrambi
quando ti serve solo la pagina. Richiede una chiave API ad accesso
completo, o `list:networks` per un membro della console.
operationId: list_networks
parameters:
- name: organization_id
in: path
required: true
schema:
type: string
format: uuid
description: UUID dell'organizzazione.
- name: application_id
in: path
required: true
schema:
type: string
format: uuid
description: UUID dell'applicazione.
- name: status
in: query
schema:
type: string
description: >-
Stati separati da virgole da includere:
active,in_review,resolved,dismissed. Omettere per escludere
dismissed.
- name: scope
in: query
schema:
type: string
enum:
- identity
- transactions
description: >-
`transactions` mantiene le reti i cui membri sono tutti parti della
transazione; `identity` mantiene tutte le altre reti. Ometti per
entrambe. Restringe anche `counts.views` e `counts.facets`.
Qualsiasi altro valore restituisce 400.
- name: signal_type
in: query
schema:
type: string
description: >-
Tipi di segnale separati da virgole:
ip_address,device,face,document_number,phone,email,address.
- name: pattern_type
in: query
schema:
type: string
description: >-
Tipi di pattern separati da virgole, ad es.
exact_same_device,same_email.
- name: risk_band
in: query
schema:
type: string
description: 'Fasce separate da virgole: low,medium,high.'
- name: min_size
in: query
schema:
type: integer
description: Numero minimo di membri.
- name: max_size
in: query
schema:
type: integer
description: Numero massimo di membri.
- name: assignee
in: query
schema:
type: string
description: >-
Assegnatari separati da virgole: `unassigned`, email dei membri
(confronto senza distinzione tra maiuscole e minuscole) o `me` per
il membro della console chiamante. Una rete corrisponde a qualsiasi
valore. `me` richiede un token di un membro della console: una
chiave API riceve 400 `{"assignee": ["\"me\" needs a user token; an
API key has no assignee identity."]}`.
- name: priority
in: query
schema:
type: string
description: >-
Priorità separate da virgole: `low`, `medium`, `high` o `none` per
le reti senza una priorità. Qualsiasi altro valore restituisce 400
`{"priority": "Unknown priority: ."}`.
- name: risk_min
in: query
schema:
type: integer
minimum: 0
maximum: 100
description: >-
Punteggio di rischio minimo, un numero intero da 0 a 100. Un valore
che non è un numero intero restituisce 400 `{"risk_min": "Use a
whole number from 0 to 100."}`.
- name: has_case
in: query
schema:
type: boolean
description: >-
`true` mantiene le reti per cui la tua applicazione ha aperto un
caso, `false` le altre. Qualsiasi altro valore viene ignorato.
- name: date_from
in: query
schema:
type: string
format: date
description: Limite inferiore su last_activity_at (data o data e ora ISO 8601).
- name: date_to
in: query
schema:
type: string
format: date
description: Limite superiore per first_activity_at (data o datetime ISO 8601).
- name: q
in: query
schema:
type: string
description: >-
Ricerca a testo libero su nome della rete, nomi dei membri,
network_id (N-0001) e token esatti di pattern_type.
- name: ordering
in: query
schema:
type: string
description: >-
Uno tra risk_score, -risk_score, last_activity_at,
-last_activity_at, first_activity_at, -first_activity_at,
network_number, -network_number. Il valore predefinito è
-risk_score,-last_activity_at.
- name: limit
in: query
schema:
type: integer
default: 100
minimum: 1
maximum: 500
description: Dimensione della pagina, 1-500. Il valore predefinito è 100.
- name: offset
in: query
schema:
type: integer
default: 0
minimum: 0
description: Offset in base zero del primo record.
- name: summary
in: query
schema:
type: boolean
default: true
description: >-
`false` restituisce solo la pagina e il relativo `count`, senza
`kpis` e `counts`. Il valore predefinito è `true`. Qualsiasi valore
diverso da `true` o `false` restituisce 400.
responses:
'200':
description: >-
Elenco impaginato delle reti, con la modalità di condivisione
dell'organizzazione e la disponibilità tra organizzazioni, oltre a
`kpis` e `counts` a meno che `summary=false`.
content:
application/json:
schema:
type: object
properties:
count:
type: integer
next:
type: integer
nullable: true
description: >-
Offset della pagina successiva, oppure null nell'ultima
pagina.
previous:
type: integer
nullable: true
results:
type: array
items:
$ref: '#/components/schemas/NetworkListItem'
kpis:
type: object
description: >-
Ogni chiave contiene {value, delta} per i risultati
corrispondenti ai filtri correnti. Omesso quando
`summary=false`.
properties:
active:
type: object
in_review:
type: object
applicants_involved:
type: object
detected_this_period:
type: object
false_positive_rate:
type: object
counts:
$ref: '#/components/schemas/NetworkListCounts'
sharing_mode:
type: string
enum:
- 'off'
- private
- global
description: >-
La modalità di condivisione tra organizzazioni
dell'organizzazione. Solo `global` confronta le reti tra
organizzazioni; `private` e `off` le limitano alla
cronologia interna dell'organizzazione.
example: global
cross_org_available:
type: boolean
description: >-
Indica se i segnali tra organizzazioni si applicano a
questa organizzazione. Richiedono sia il piano Enterprise
sia la modalità di condivisione `global`.
example: true
cross_org_unavailable_reason:
type: string
enum:
- plan
- sharing_mode
nullable: true
description: >-
Il motivo per cui i segnali inter-organizzazione non sono
applicabili, verificati in questo ordine. `plan`: il piano
dell'organizzazione non include la rete antifrode
inter-organizzazione (richiede il piano Enterprise),
indipendentemente dalla modalità di condivisione.
`sharing_mode`: il piano la include, ma la modalità di
condivisione è `private` o `off`. Null quando
`cross_org_available` è `true`.
example: null
required:
- count
- next
- previous
- results
- sharing_mode
- cross_org_available
- cross_org_unavailable_reason
'400':
description: >-
Un valore non valido per filtro, ordinamento, paginazione o
`summary`.
content:
application/json:
examples:
Invalid summary:
summary: Riepilogo non valido
value:
summary:
- Must be "true" or "false".
Invalid scope:
summary: Ambito non valido
value:
scope:
- Use identity or transactions.
Unsupported ordering:
summary: Ordinamento non supportato
value:
- Unsupported ordering.
'401':
description: Credenziali mancanti o non valide.
content:
application/json:
schema:
type: object
properties:
detail:
type: string
code:
type: string
description: >-
Presente sugli errori codificati, ad esempio
`networks_not_entitled`.
examples:
Missing or invalid credentials:
summary: Credenziali mancanti o non valide
value:
detail: >-
Authentication credentials were not provided or are
invalid.
'403':
description: >-
La chiave API appartiene a un'altra applicazione, oppure è una
chiave con accesso limitato: gli endpoint Networks richiedono una
chiave con accesso completo. Un token di un membro della console
richiede `list:networks`. Viene restituito anche con `code:
networks_not_entitled` quando Networks non è abilitato per
l'organizzazione.
content:
application/json:
schema:
type: object
properties:
detail:
type: string
code:
type: string
description: >-
Presente sugli errori codificati, ad esempio
`networks_not_entitled`.
examples:
Networks not enabled:
summary: Reti non abilitate
value:
detail: >-
Networks is disabled for this organization. Contact Didit
support if you believe this is an error.
code: networks_not_entitled
Restricted API key:
summary: Chiave API con restrizioni
value:
detail: This API key has no access to this endpoint.
No permission:
summary: Nessuna autorizzazione
value:
detail: You do not have permission to perform this action.
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/?status=active,in_review&ordering=-risk_score'
\
-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()
for item in client.networks.list():
print(item)
- 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();
for await (const item of didit.networks.list()) {
console.log(item);
}
- 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\niter := client.Networks.ListAutoPaging(ctx, didit.NetworksListParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}"
- lang: java
label: Java
source: |-
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);
}
- lang: php
label: PHP
source: |-
networks->list() as $item) {
print_r($item->toArray());
}
- lang: ruby
label: Ruby
source: |-
require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
didit.networks.list.auto_paging_each do |item|
puts item.to_h
end
- 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();
await foreach (var item in await client.Networks.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}
components:
schemas:
NetworkListItem:
type: object
properties:
uuid:
type: string
format: uuid
network_id:
type: string
description: >-
ID sequenziale per organizzazione leggibile dall'utente, ad es.
N-0001.
name:
type: string
nullable: true
status:
type: string
enum:
- active
- in_review
- resolved
- dismissed
description: >-
Stato del ciclo di vita della rete. Distinto dall'outcome_status per
richiedente all'interno di una rete
(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: I pattern di clustering rilevati in questa rete.
signal_types:
type: array
items:
type: string
enum:
- ip_address
- device
- face
- document_number
- phone
- email
- address
description: I diversi tipi di segnale presenti in questa rete.
member_counts:
type: object
description: >-
Conteggi dei membri per categoria (ad es. totale, per
outcome_status).
member_status:
type: object
description: Suddivisione dei membri per outcome_status.
signal_coverage:
type: object
description: Copertura per signal_type dei membri di questa rete.
first_activity_at:
type: string
format: date-time
nullable: true
last_activity_at:
type: string
format: date-time
nullable: true
NetworkListCounts:
type: object
description: >-
Conteggi delle reti per le viste e le opzioni di filtro dell'elenco, con
ogni rete conteggiata una volta sola. Restituito solo quando `summary`
non è `false`. `scopes` conta ogni rete visibile all'applicazione.
`views` conta le reti visibili all'interno dello `scope` selezionato.
`facets` conta le reti nello `scope` e nella vista `status` selezionati
(le reti ignorate sono escluse a meno che `status` non le includa). Gli
altri filtri dell'elenco non modificano questi conteggi.
properties:
scopes:
type: object
description: Reti visibili per prodotto.
properties:
all:
type: integer
identity:
type: integer
description: Ogni altra rete.
transactions:
type: integer
description: Reti i cui membri sono tutti parti della transazione.
views:
type: object
description: >-
Reti visibili all'interno dello `scope` selezionato, per stato, più
due visualizzazioni salvate.
properties:
all:
type: integer
active:
type: integer
in_review:
type: integer
resolved:
type: integer
dismissed:
type: integer
mine:
type: integer
description: >-
Reti assegnate al membro della console che effettua la chiamata.
Sempre 0 per una chiave API.
high_risk:
type: integer
description: >-
Reti con un punteggio di rischio pari o superiore a 80 che non
sono state ignorate.
facets:
type: object
description: >-
Conteggi per ciascuna opzione di filtro, all'interno dello `scope` e
della vista di stato selezionati.
properties:
total:
type: integer
description: Reti nello `scope` e nella vista di stato selezionati.
last_activity_days:
type: object
description: >-
Reti con attività negli ultimi 7, 30 e 90 giorni, indicizzate
per numero di giorni.
properties:
'7':
type: integer
'30':
type: integer
'90':
type: integer
risk_min:
type: object
description: >-
Reti con un punteggio di rischio pari ad almeno 50 e ad almeno
80, indicizzate per soglia.
properties:
'50':
type: integer
'80':
type: integer
signal_types:
type: object
description: Reti con almeno un segnale di ciascun tipo.
properties:
ip_address:
type: integer
device:
type: integer
face:
type: integer
document_number:
type: integer
phone:
type: integer
email:
type: integer
address:
type: integer
priority:
type: object
description: Reti per priorità. `none` conta le reti senza una priorità.
properties:
low:
type: integer
medium:
type: integer
high:
type: integer
none:
type: integer
assignee:
type: object
description: Reti per assegnatario.
properties:
me:
type: integer
description: >-
Assegnato al membro della console che effettua la chiamata.
Sempre 0 per una chiave API.
unassigned:
type: integer
description: Non assegnato a nessuno.
users:
type: array
description: >-
Una voce per assegnatario, prima gli assegnatari con il
maggior numero di reti.
items:
type: object
properties:
uuid:
type: string
format: uuid
full_name:
type: string
description: >-
Il nome dell'assegnatario, o la sua email se non è
impostato alcun nome.
email:
type: string
count:
type: integer
has_case:
type: integer
description: Reti per cui questa applicazione ha aperto un caso.
min_size:
type: object
description: Reti con almeno 10 membri, indicizzate per dimensione minima.
properties:
'10':
type: integer
NetworkRiskDisplay:
type: object
properties:
score:
type: integer
description: Punteggio di rischio, 0-100.
band:
type: string
enum:
- low
- medium
- high
description: >-
Fascia a cui viene assegnato il punteggio. high >= 70, medium >= 40,
altrimenti low.
bar:
type: number
format: float
description: >-
Valore normalizzato compreso tra 0 e 1 per il rendering di una barra
di rischio.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: >-
La chiave API della tua applicazione, da Developers -> API keys nella
Business Console. La chiave primaria ha accesso completo. Una chiave con
nome può avere un ambito definito: nessuno, lettura o scrittura per
risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco
di indirizzi IP e a una data di scadenza. 401 indica che la chiave è
errata, revocata o scaduta; 403 indica che non è stata inviata alcuna
chiave, che la chiave non ha accesso a questa risorsa o azione, oppure
che la richiesta proviene da un indirizzo non incluso nel suo elenco IP;
404 su una route di sessione indica che la sessione non rientra nei
workflow o negli stati previsti dalla chiave. Una chiave senza accesso
ai media riceve gli URL di immagini, video e PDF come null, e una chiave
senza permessi di scrittura sulle sessioni riceve link e token di
sessione come null. Consulta https://docs.didit.me/console/api-keys.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.