Zum Hauptinhalt springen
GET
curl
Der Bericht wird bei Bedarf aus den aktuellen Daten der Transaktion erzeugt. Rufen Sie ihn daher nach einer Statusänderung erneut auf, um eine aktuelle Kopie zu erhalten. Anders als die anderen Transaktions-Endpoints liegt dieser auf einem anwendungsbezogenen Pfad: Tragen Sie in die URL Ihre Organisations-ID und die ID der Anwendung ein, zu der Ihr API-Schlüssel gehört. Siehe Organisations-ID finden.
Ein PDF-Bericht zählt als Medium. Ein bereichsbezogener API-Schlüssel benötigt media: read zusätzlich zu transactions: read. Ein Schlüssel ohne Medienzugriff erhält 403, selbst wenn er die Transaktion als JSON mit Transaktion abrufen lesen kann.

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

organization_id
string<uuid>
erforderlich

UUID der Organisation.

application_id
string<uuid>
erforderlich

Anwendungs-UUID. Muss die Anwendung sein, zu der der API-Schlüssel gehört: Ein für eine andere Anwendung verwendeter Schlüssel erhält 403.

transaction_uuid
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.

Antwort

Das gerenderte PDF, direkt als binäres application/pdf zurückgegeben.

The response is of type file.

Zuletzt geändert am 7. November 2026