Signaturprofil-Logo hochladen

Der multipart-Upload akzeptiert PNG, JPEG oder GIF bis 500 KB mit 200 bis 1000 Pixeln Kantenlänge. Mit Produktivschlüssel wird das Logo an den Signaturdienst übertragen und erscheint in der Signaturansicht. Erforderlich ist signature_profiles:write.

Beschreibung

Lädt das Logo eines Signaturprofils hoch oder ersetzt es.

Parameter

signature_profile_idpathPflicht

Öffentliche Signaturprofil-ID.

Beispiel: sgp_test_6f708192a3b4c5d6e7f8091a

Idempotency-KeyheaderPflicht

Eindeutig für diesen Logo-Upload.

Beispiel: signature-profile-logo-6f70-v1

Request-Body

Der Body wird als multipart/form-data übertragen. Setzen Sie den Content-Type nicht selbst; Ihr HTTP-Client ergänzt die notwendige Boundary.

Request-Felder

logoDateiPflicht

Logodatei als PNG, JPEG oder GIF; maximal 500 KB, 200 bis 1000 Pixel.

Erlaubte MIME-Typen: image/png,image/jpeg,image/gif

SchemaquelleOpenAPI 3.1 herunterladen

Responses

200

Logo gespeichert; ein vorhandenes Logo wurde ersetzt.

413

Die gesamte Multipart-Anfrage überschreitet das Größenlimit.

422

Logodatei ist zu groß, hat unzulässige Abmessungen oder einen nicht unterstützten Dateityp.

502

Der Signaturdienst hat das Logo nicht angenommen; der Profilzustand bleibt unverändert.

Response-Body

Content-Type: application/json. Die erfolgreiche Antwort enthält die nachfolgend beschriebenen Felder.

Response-Felder

Feld	Typ	Angabe	Beschreibung
`id`	string	Immer	Öffentliche Signaturprofil-ID.
`object`	string	Immer	Konstanter Wert `signature_profile`.
`environment`	enum	Immer	`test` oder `live`.
`livemode`	boolean	Immer	`true` bei Produktivprofilen.
`name`	string	Optional	Interne Bezeichnung.
`display_name`	string	Immer	Absendername der Signaturanfrage.
`redirect_url`	string	Optional	Redirect-Ziel nach Abschluss der Signatur.
`has_logo`	boolean	Immer	Gibt an, ob ein Logo hinterlegt ist.
`logo_url`	string	Optional	Relativer Pfad der gespeicherten Logodatei.
`created_at`	date-time	Immer	Erstellungszeitpunkt.
`updated_at`	date-time	Immer	Letzter Änderungszeitpunkt.

{
  "id": "sgp_test_6f708192a3b4c5d6e7f8091a",
  "object": "signature_profile",
  "environment": "test",
  "livemode": false,
  "name": "Standardprofil",
  "display_name": "Autohaus Beispiel GmbH",
  "redirect_url": "https://autohaus-beispiel.de/zulassung/abgeschlossen",
  "has_logo": true,
  "created_at": "2026-08-27T09:30:00+02:00",
  "updated_at": "2026-08-27T09:30:00+02:00",
  "logo_url": "/assets/uploads/public-api-signature-profiles/sgp_test_6f708192a3b4c5d6e7f8091a-1a2b3c4d5e6f.png"
}

Testverhalten

{ "id": "sgp_test_6f708192a3b4c5d6e7f8091a", "object": "signature_profile", "environment": "test", "livemode": false, "name": "Standardprofil", "display_name": "Autohaus Beispiel GmbH", "redirect_url": "https://autohaus-beispiel.de/zulassung/abgeschlossen", "has_logo": true, "created_at": "2026-08-27T09:30:00+02:00", "updated_at": "2026-08-27T09:30:00+02:00", "logo_url": "/assets/uploads/public-api-signature-profiles/sgp_test_6f708192a3b4c5d6e7f8091a-1a2b3c4d5e6f.png" }