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));Unternehmen per Batch löschen: API für KYB-Löschung
Löschen Sie Didit-Unternehmensentitäten (KYB) stapelweise per vendor_data oder didit_internal_id. DSGVO- und CCPA-konform.
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));Überblick
Löscht eine oder mehrere Unternehmensentitäten. Die Unternehmensdatensätze werden dauerhaft entfernt. Sitzungen für die Unternehmensverifizierung (KYB) werden von diesem Endpoint nicht erfasst. Sie bleiben erhalten, und ihre Verknüpfung mit dem Unternehmen wird entfernt. Löschen Sie sie mit Sitzung löschen. Transaktionen werden ebenfalls nicht erfasst. Löschen Sie sie mit Transaktionen im Batch löschen.Wann verwenden
- Anfragen zum Recht auf Vergessenwerden.
- Bereinigung von Testunternehmen während der QA.
- Deprovisionierung von Unternehmen, die von Ihrer eigenen Plattform entfernt wurden.
Hinweise
- Akzeptiert eine Liste von
vendor_data-Werten oderdidit_internal_id-Werten. - Idempotent: Das Löschen eines bereits gelöschten Unternehmens hat keine Wirkung.
- Gibt nur die Anzahl der gelöschten Elemente zurück, keinen Bericht pro Element. Werte ohne Treffer werden stillschweigend übersprungen.
- Sendet
business.data.updatedmit gesetztemdeleted_at. - Datensätze, die der Unternehmensentität selbst gehören, werden mit ihr gelöscht: ihre Tag-Verknüpfungen, ihr Kommentarverlauf sowie ihre eigenen Geräte- und Netzwerkdatensätze.
- Datensätze, die durch eine KYB-Sitzung entstehen, werden NICHT mitgelöscht: Unternehmensregisterdaten, hochgeladene Dokumente, AML-Treffer, wirtschaftlich Berechtigte und Prüfungen der Schlüsselpersonen gehören zur Sitzung und bleiben erhalten, bis Sie die Sitzung selbst löschen.
Daten in einem finalisierten regulatorischen Bericht
Wenn ein ausgewähltes Unternehmen Teil eines Falls mit einem finalisierten regulatorischen Bericht ist, gibt die gesamte Anfrage409 zurück, und nichts wird gelöscht. Die Antwort enthält code: in_filed_report und nennt jeden Bericht:
{
"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"
}
]
}
Eine laufende Löschung
Ein Unternehmen wird jeweils nur durch eine Anfrage gelöscht. Wenn eine andere Anfrage gerade eines der ausgewählten Unternehmen löscht, wartet diese Anfrage höchstens einige Sekunden. Danach gibt sie409 mit code: subject_deletion_in_progress zurück und löscht nichts:
{
"detail": "This person or company is being deleted. Retry after deletion completes.",
"code": "subject_deletion_in_progress"
}
Berechtigungen
Die Rolle mussdelete:businesses gewähren. In der Regel ist diese Berechtigung OWNER und ADMIN vorbehalten.
Verwandte Themen
Autorisierungen
Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.
Body
Geben Sie vendor_data_list, didit_internal_id_list oder delete_all: true an. Rangfolge, wenn mehrere gesendet werden: delete_all > vendor_data_list > didit_internal_id_list (nur der Selektor mit dem höchsten Vorrang wird verwendet).
Ihre eigenen zu löschenden Kennungen, exakt so abgeglichen wie übermittelt.
Zu löschende interne Didit-UUIDs (didit_internal_id).
Wenn true, werden alle Unternehmen in der Anwendung gelöscht. Kann nicht mit den Listen-Selektoren kombiniert werden.
Antwort
Unternehmen gelöscht. Gibt die Anzahl der tatsächlich entfernten Zeilen zurück.
Anzahl der gelöschten Unternehmen (schließt vendor_data-Werte aus, die mit nichts übereinstimmten).