curl -X POST 'https://verification.didit.me/v3/businesses/delete/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"vendor_data_list": ["company-123", "company-456"]}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.businesses.batch_delete(
vendor_data_list=["company-123", "company-456"],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.businesses.batchDelete({
vendor_data_list: ["company-123", "company-456"],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Businesses.BatchDelete(ctx, didit.BusinessesBatchDeleteParams{
VendorDataList: didit.Some([]string{"company-123", "company-456"}),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.BusinessesBatchDeleteParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.businesses().batchDelete(BusinessesBatchDeleteParams.builder()
.vendorDataList(List.of("company-123", "company-456"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->businesses->batchDelete([
'vendor_data_list' => ['company-123', 'company-456'],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.businesses.batch_delete(vendor_data_list: ["company-123", "company-456"])
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Businesses.BatchDeleteAsync(new BusinessesBatchDeleteParams
{
VendorDataList = new string[] { "company-123", "company-456" },
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"deleted": 2
}API per eliminare aziende in batch: cancellazione KYB
Con Didit puoi eliminare in blocco le entità aziendali (KYB) tramite vendor_data o didit_internal_id. Conforme a GDPR e CCPA.
curl -X POST 'https://verification.didit.me/v3/businesses/delete/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"vendor_data_list": ["company-123", "company-456"]}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.businesses.batch_delete(
vendor_data_list=["company-123", "company-456"],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.businesses.batchDelete({
vendor_data_list: ["company-123", "company-456"],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Businesses.BatchDelete(ctx, didit.BusinessesBatchDeleteParams{
VendorDataList: didit.Some([]string{"company-123", "company-456"}),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.BusinessesBatchDeleteParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.businesses().batchDelete(BusinessesBatchDeleteParams.builder()
.vendorDataList(List.of("company-123", "company-456"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->businesses->batchDelete([
'vendor_data_list' => ['company-123', 'company-456'],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.businesses.batch_delete(vendor_data_list: ["company-123", "company-456"])
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Businesses.BatchDeleteAsync(new BusinessesBatchDeleteParams
{
VendorDataList = new string[] { "company-123", "company-456" },
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"deleted": 2
}Panoramica
Elimina una o più entità aziendali. I record delle aziende vengono rimossi in modo permanente. Le sessioni di Verifica aziendale (KYB) non sono coperte da questo endpoint e restano, con il collegamento all’azienda azzerato: eliminale con Elimina sessione. Anche le transazioni non sono coperte: eliminale con Eliminazione in blocco delle transazioni.Quando usarlo
- Richieste di diritto all’oblio.
- Pulizia delle aziende di test durante il QA.
- Dismissione delle aziende rimosse dalla tua piattaforma.
Note
- Accetta un elenco di valori
vendor_datao di valorididit_internal_id. - Idempotente: eliminare un’azienda già eliminata non produce alcun effetto.
- Restituisce solo il conteggio di ciò che è stato eliminato, non un report per singolo elemento. I valori che non corrispondono a nulla vengono ignorati senza segnalazioni.
- Emette
business.data.updatedcondeleted_atvalorizzato. - I record di proprietà dell’entità aziendale stessa vengono eliminati insieme a essa: i suoi collegamenti ai tag, la cronologia dei commenti e i propri record di dispositivo e di rete.
- I record prodotti da una sessione KYB NON vengono eliminati: i dati del registro delle imprese, i documenti caricati, i riscontri AML, i titolari effettivi e i controlli sulle persone chiave appartengono alla sessione e restano finché non elimini la sessione stessa.
Dati in un report normativo finalizzato
Se una qualsiasi azienda selezionata fa parte di un caso con un report normativo finalizzato, l’intera richiesta restituisce409 e non viene eliminato nulla. La risposta usa code: in_filed_report e indica ciascun report:
{
"detail": "A case about this person or company has a filed regulatory report, so it cannot be deleted.",
"code": "in_filed_report",
"reports": [
{
"uuid": "5ec00000-0000-4000-8000-000000000007",
"report_number": "SAR-0001",
"report_type": "SAR",
"case_uuid": "c1a5e000-0000-4000-8000-000000000001"
}
]
}
Un’eliminazione già in corso
Un’azienda viene eliminata da una sola richiesta alla volta. Se un’altra richiesta sta ancora eliminando una delle aziende selezionate, questa richiesta attende al massimo qualche secondo, quindi restituisce409 con code: subject_deletion_in_progress e non elimina nulla:
{
"detail": "This person or company is being deleted. Retry after deletion completes.",
"code": "subject_deletion_in_progress"
}
Autorizzazioni
Il ruolo deve concederedelete:businesses. Di norma è riservato a OWNER e ADMIN.
Correlati
Autorizzazioni
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.
Corpo
Fornisci vendor_data_list, didit_internal_id_list o delete_all: true. Ordine di precedenza quando ne vengono inviati diversi: delete_all > vendor_data_list > didit_internal_id_list (viene utilizzato solo il selettore con precedenza più alta).
I tuoi identificatori da eliminare, confrontati esattamente come inviati.
UUID interni Didit (didit_internal_id) da eliminare.
Se true, elimina ogni azienda nell'applicazione. Non può essere combinato con i selettori di elenco.
Risposta
Aziende eliminate. Restituisce il numero di righe effettivamente rimosse.
Numero di aziende eliminate (esclude i valori di vendor_data che non corrispondevano a nulla).