Skip to main content
GET
Download an order attachment

Auf einen Blick

Betriebsverhalten

Lädt das von einem Bestellanhang referenzierte Vertragsdokument herunter.
  • Verwenden Sie eine Attachment-ID aus einer Bestellungs-Response. Prüfen Sie Status und Content-Type, bevor Sie die Response als Datei behandeln.

Häufige Fehler

Die Response-Liste der Operation und die Seite Fehlerbehandlung sind für die vollständige Behandlung maßgeblich.

Vor der Implementierung

  • Erzeugen und protokollieren Sie für den Versuch eine neue X-Request-ID.
  • Behandeln Sie jeden dokumentierten Response-Status.
  • Protokollieren Sie weder X-API-Key noch unnötige personenbezogene Daten.
  • Verwerfen Sie unvollständige Dateien nach Netzwerkunterbrechungen oder transienten Upstream-Fehlern.

Zugehöriger Integrationsleitfaden

Prüfen Sie den vollständigen Prozess sowie Status-, Retry- und Betriebsmuster für diese Operation.

Autorisierungen

X-API-Key
string
header
erforderlich

JobHandy integration API key. Send the credential in the X-API-Key header. Treat the key as a secret and use it only from trusted server-side environments.

Header

X-Tenant-ID
string
inactive
optional
not sent by default

Narrows the operation to one tenant in the API key's scope. Any referenced or target resource must be accessible through that tenant. In interactive clients, use the {{tenantId}} variable when a tenant must be selected. Keep the header disabled when tenant selection is not required.

Pattern: ^[0-9a-fA-F]{24}$
X-Request-ID
string<uuid>
inactive
optional
not sent by default

Optional request identifier. If supplied, it must be a UUID v4 or v7 and is returned unchanged in every response. If omitted, the API generates one. Invalid values return 400 INVALID_REQUEST_ID. If your client uses a {{requestId}} variable, refresh it with a new UUID version 4 or 7 for every HTTP request attempt. Keep the header disabled to let the API generate the request identifier.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[47][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

Pfadparameter

id
string
erforderlich

Attachment ID from an order response.

Beispiel:

"contract.10495.1"

Antwort

The requested contract document.

The response is of type file.

Zuletzt geändert am 27. August 2026