Zum Hauptinhalt springen
GET
curl
Notizen sind die Zeitleiste einer Transaktion für Analysten: dieselbe Liste, die Prüfer unter Notizen auf dem Transaktionsdetail in der Console sehen. Fügen Sie eigene Notizen mit Transaktionsnotiz erstellen hinzu, und lesen Sie die Transaktion selbst, einschließlich ihrer activities, mit Transaktion abrufen. Notizen mit actor_name gleich Rule Engine stammen von Didit: entweder aus einer add_note-Aktion einer Regel oder aus einem Problem beim Erstellen der Verifizierungssitzung für Benutzeraktionen für eine Transaktion im Status AWAITING_USER (die Sitzung konnte nicht erstellt werden oder Didit ist auf einen anderen Workflow ausgewichen).

Autorisierungen

x-api-key
string
header
erforderlich

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.

Pfadparameter

transaction_id
string<uuid>
erforderlich

Didit-Transaktions-UUID: die von POST /v3/transactions/ und GET /v3/transactions/ zurückgegebene uuid. Ihre eigene txn_id wird nicht akzeptiert.

Abfrageparameter

limit
integer
Standard:50

Anzahl der Notizen pro Seite. Standardmäßig 50. Ein Wert, der keine positive Ganzzahl ist, fällt auf 50 zurück; ein Wert über 1000000 gibt 400 zurück.

Erforderlicher Bereich: 1 <= x <= 1000000
offset
integer
Standard:0

Nullbasierte Position der ersten zurückzugebenden Notiz. Folgen Sie vorzugsweise next. Ein Wert, der keine ganze Zahl ist, fällt auf 0 zurück; ein Wert über 1000000 gibt 400 zurück.

Erforderlicher Bereich: 0 <= x <= 1000000

Antwort

Eine Seite mit Notizen, neueste zuerst.

count
integer
erforderlich

Anzahl der Notizen zur Transaktion: exakt bis 100, darüber auf 100 begrenzt. Folgen Sie next, anstatt daraus Seiten zu berechnen.

next
string<uri> | null
erforderlich

Absolute URL der nächsten Seite oder null auf der letzten Seite.

previous
string<uri> | null
erforderlich

Absolute URL der vorherigen Seite oder null auf der ersten Seite.

results
object[]
erforderlich
Zuletzt geändert am 7. November 2026