# Integration mit klarem Umfang beginnen.

> Greifen Sie auf Legichain-API-Dokumentation, SDK-Ressourcen und Integrationsinformationen zu. Prüfen Sie Anfrage-, Antwort- und Fehlerszenarien.

Kanonische URL: https://legichain.com/de/developers
Sprache: de
Weitere Sprachen (tr): https://legichain.com/developers
Weitere Sprachen (en): https://legichain.com/en/developers
Weitere Sprachen (es): https://legichain.com/es/developers
Weitere Sprachen (it): https://legichain.com/it/developers

Prüfen Sie API-Struktur, erforderliche Datenfelder und Antworten. Definieren Sie den passenden Kontrollablauf für Ihr Produkt.

- [V3-API-Referenz öffnen](https://legichain.com/de/developers#api-reference)
- [Interaktiver Integrationsleitfaden](https://legichain.com/de/integration-guide)

**Anfrage** — POST /v3/products · Idempotency-Key

```
{
  "product": "aml",
  "name": "Example Customer",
  "retention_years": 0
}
```

**Annahmebestätigung** — 202 Accepted

```
{
  "id": "tr_example_result",
  "persona_id": "tr_example_persona",
  "onboarding_id": "tr_example_session",
  "product": "aml",
  "status": "pending",
  "session_token": "SCOPED_SESSION_TOKEN"
}
```

**Fehlerformat** — 422

```
{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "details": {}
  }
}
```

## Konkrete API-Verträge für Ihre V3-Integration.

Laden Sie separate OpenAPI-3.1-Dateien für die regionale API, zugewiesene Rechenressourcen und den Medienzugriff herunter. Nutzen Sie Anfragen, Antworten, Berechtigungen und Fehlerformate für Ihre Integration.

- [Regionale API · OpenAPI JSON](https://legichain.com/assets/api/openapi-api.json)
- [Compute-Dienst · OpenAPI JSON](https://legichain.com/assets/api/openapi-compute.json)
- [Mediendienst · OpenAPI JSON](https://legichain.com/assets/api/openapi-media.json)
- [Integrationsleitfaden · englisches Markdown](https://legichain.com/assets/api/integration.md)
- **Authentifizierung auf Ihrem Backend** — Der an den Workspace gebundene Bearer-API-Schlüssel bleibt auf Ihrem Backend. Panel-Sitzungen wählen den Workspace mit X-Workspace-ID. Senden Sie den Schlüssel niemals an Apps, Browser oder Compute-Hosts.
- **Persona und neue Sitzung** — Ordnen Sie Ihre stabile Kundenreferenz mit POST /v3/personas zu und erstellen Sie die ausgewählten Leistungen mit POST /v3/onboardings. Das Gerät erhält nur den sitzungsgebundenen session_token und vertrauenswürdige Verbindungsdaten. Ein neues Onboarding ist ein neuer Versuch; leere Sitzungen und Wartezeiten sind kostenfrei.
- **Direkt zum zugewiesenen Compute hochladen** — Nehmen Sie ein Warteschlangenangebot mit claim an, um compute_url und compute_token zu erhalten. Laden Sie Rohdaten direkt dorthin hoch, ohne Multipart. KI-Aufnahmen senden neue Fragmente desselben Recorders. LiveKit wird nur für manuelle Videoanrufe verwendet.
- **Warteschlange und asynchrone Ergebnisse** — Verfolgen Sie die Warteschlange über den Status-Endpunkt oder authentifiziertes SSE. Eine 202-Produktantwort bedeutet zur Verarbeitung angenommen, nicht genehmigt. Lesen Sie den Endstatus aus der regionalen API. Prüfen Sie Webhook-Signaturen über Rohdaten und deduplizieren Sie Ereignis-IDs; die Reihenfolge kann abweichen.
- **Wiederholungen, Seitennavigation und Fehler** — Wiederholen Sie dieselbe Änderung mit identischem Inhalt und Idempotency-Key. Übergeben Sie next_cursor als after für die nächste Seite. Reagieren Sie auf error.code; aktualisieren Sie bei 409 den Status und beachten Sie Retry-After bei 429/503. Kapazitäts- oder technische Fehler sind keine Identitätsablehnung.
- **SDK-Bereitstellung und Versionsumfang** — Der V3-Integrationskandidat dev.2 umfasst Node-, Python-, .NET- und Java-Pakete sowie ein Go-Quellarchiv. Es gibt keine öffentliche Registry-Veröffentlichung. Klären Sie Paketbereitstellung, Manifestprüfung und Plattformabnahme mit unserem Team. OpenAPI-Dateien sind keine Bereitstellungs- oder Kapazitätszusage.

> Synthetisches V3-Beispiel; keine Live-Anfrage.

## Erste Integrationsschritte.

Definieren Sie in vier Schritten den Umfang, richten Sie sicheren Zugriff ein und implementieren Sie neben der erfolgreichen Antwort auch Prüf- und Fehlerzustände.

- **Produkt wählen.** — Benötigte Kontrolle und deren Umfang festlegen.
- **Authentifizierung einrichten.** — API-Zugangsdaten nur in einer sicheren Serverumgebung verwenden.
- **Beispielanfrage ausführen.** — Nutzungsbedingungen der Testumgebung beachten.
- **Fehler- und Prüfzustände implementieren.** — Nicht nur die erfolgreiche Antwort gestalten.

## Netzwerk und Tiefe für die Wallet-Prüfung wählen.

Lesen Sie zuerst die aktivierten Netzwerke aus der regionalen wallet-capabilities-Antwort. Senden Sie dann eine ausdrückliche chain und wallet_depth: 0 nur für den Adresslistenabgleich, 1 für direkte Gegenparteien, 2 für direkte und indirekte Gegenparteien. Standardtiefe ist 2; Asset-Kürzel wie USDT ersetzen keine Netzwerkauswahl.

- **Asynchrone Ergebnisse mit ihrem Umfang lesen** — Rufen Sie GET /v3/products/{id} mit der bei der Erstellung erhaltenen id ab. potential_match ist ein zu prüfender Listenbefund. no_match bedeutet keinen Treffer innerhalb der vollständig geprüften Abdeckung. inconclusive bedeutet unvollständige Prüfung, keine automatische Freigabe. Bewahren Sie trace.complete, reasons, coverage, limitations und snapshot auf.

> Ungültige Netzwerke oder Adressen sowie inaktive regionale Anbieter werden vor der Kreditbelastung abgelehnt. API-Zugangsdaten bleiben serverseitig. Die folgende Adresse dient nur als Syntaxbeispiel; das Beispiel sendet keine Netzwerkanfrage.

**Prüfanfrage** — POST /v3/products

```json
{
  "product": "wallet_screening",
  "address": "0x1111111111111111111111111111111111111111",
  "chain": "ETH",
  "wallet_depth": 2,
  "retention_years": 0
}
```

**Aktivierte Netzwerke** — GET /v3/products/wallet-capabilities

```
GET /v3/products/wallet-capabilities
```

**Ergebnis abrufen** — GET /v3/products/{id}

```
GET /v3/products/{id}
```

## Ressourcen.

- **Interaktiver Integrationsleitfaden** — Wählen Sie Prüfungen und Codesprache und erstellen Sie einen Schritt-für-Schritt-Leitfaden für Sitzungen, direkte Uploads und Ergebnisse.
  - https://legichain.com/de/integration-guide
- **Regionale API · OpenAPI JSON** — Laden Sie separate OpenAPI-3.1-Dateien für die regionale API, zugewiesene Rechenressourcen und den Medienzugriff herunter. Nutzen Sie Anfragen, Antworten, Berechtigungen und Fehlerformate für Ihre Integration.
  - https://legichain.com/de/developers#api-reference
- **Integrationsleitfaden · englisches Markdown** — Laden Sie den englischen technischen Leitfaden zu Authentifizierung, Sitzungen und Medien, Webhook-Prüfung und Installation der dev.2-Pakete herunter.
  - https://legichain.com/assets/api/integration.md
- **SDK-Bereitstellung und Versionsumfang** — Der V3-Integrationskandidat dev.2 umfasst Node-, Python-, .NET- und Java-Pakete sowie ein Go-Quellarchiv. Es gibt keine öffentliche Registry-Veröffentlichung. Klären Sie Paketbereitstellung, Manifestprüfung und Plattformabnahme mit unserem Team. OpenAPI-Dateien sind keine Bereitstellungs- oder Kapazitätszusage.
  - https://legichain.com/de/contact?topic=integration
- **Systemstatus** — Aktuelle Serviceinformationen.
  - https://legichain.com/de/status

## Vor dem Produktivbetrieb prüfen.

Bewerten Sie Berechtigungen, Ratenlimits, Wiederholungen, Protokollierung und sensible Daten zusammen mit den Anforderungen Ihrer Anwendung. Webhooks oder Idempotenz dürfen nur im dokumentierten Umfang des jeweiligen Endpunkts genutzt werden.

- **Berechtigung** — Geheimer Schlüssel nur serverseitig, niemals im Clientcode.
- **Ratenlimits** — Limitantworten und Warteintervalle implementieren.
- **Wiederholung** — Nur bei wiederholbaren Fehlern und mit derselben Referenz.
- **Protokollierung** — Identitäts- und Wallet-Daten werden in Protokollen maskiert.
- **Umgang mit sensiblen Daten** — Aufbewahrung und Zugriff entsprechend dem Vertragsumfang.
- **Prüfzustand** — Für die Antwort „review_required“ wird ein Teamablauf definiert.

## Über die Integration.

### Darf der API-Schlüssel in einer Clientanwendung stehen?

Speichern Sie geheime Zugangsdaten nicht in öffentlich zugänglichem Clientcode. Beachten Sie das Berechtigungsmodell der jeweiligen Integration.

### Sind die Beispielantworten Live-Daten?

Dokumentationsbeispiele sind als Beispiele gekennzeichnet. Live-Produktantworten und Testdaten werden getrennt gehalten.

## Haben Sie eine technische Frage?

Teilen Sie Ihr Integrationsszenario mit. Klären wir gemeinsam den erforderlichen Produkt- und Datenumfang.

- [Technisches Gespräch anfragen](https://legichain.com/de/contact?topic=integration)

---
Legichain — Technologie für digitale Identität, AI Video KYC und Risikoprüfung. Kontakt: contact@legichain.com
