API-Referenz

Integrieren Sie die Duplikaterkennung von True Record über REST-API in Ihre Workflows.

Basis-URL

https://truerecord.app/api/v1

Authentifizierung

Alle API-Anfragen erfordern ein Bearer-Token.

Authorization-Header-Format

Authorization: Bearer tr_xxxxxxxxxxxxxxxx
API-Schlüssel erstellen

API-Berechtigungen

API-Schlüssel sind auf bestimmte Berechtigungen beschränkt.

ScopeDescription
scans:readScan-Status anzeigen
scans:writeScans starten
matches:readTreffer anzeigen
matches:mergeZusammenführen
matches:dismissTreffer verwerfen
import:readImport-Jobs anzeigen
import:writeImporte ausführen
org:readOrg-Info anzeigen
*Vollzugriff

Endpunkte

GET/org/status

Organisationsinformationen abrufen.

Scope: org:read

POST/scan/start

Neuen Scan starten.

Scope: scans:write

GET/scan/status/:scanId

Scan-Ergebnisse abrufen.

Scope: scans:read

GET/matches

Duplikat-Treffer abrufen.

Scope: matches:read

POST/matches/:matchId/merge

Treffer zusammenführen.

Scope: matches:merge

POST/matches/:matchId/dismiss

Treffer verwerfen.

Scope: matches:dismiss

Ratenlimits

Ratenlimits variieren je nach Plan:

PlanAnfragen/Min
Professional60
Business120
Enterprise300

Ratenlimit-Header sind in jeder Antwort enthalten.

Fehlerantworten

Alle Fehler folgen einem einheitlichen Format:

400Bad Request - Ungültige Parameter
401Unauthorized - Ungültiger API-Schlüssel
403Forbidden - Unzureichende Berechtigungen
404Not Found - Ressource existiert nicht
429Too Many Requests - Ratenlimit überschritten
500Internal Server Error

Weitere Ressourcen