ConverterHQDevelopers
API v1

Signierte URLs

Uploads, Downloads und Konvertierungen ohne Offenlegung eines API-Schlüssels.

ConverterHQ trennt Storage-Signaturen von signierten Konvertierungen, die einen begrenzten Workflow starten dürfen.

Richtliniengebundene Konvertierung
Client
Signed URLExpiry + policy
Workflow Job
Output
Die signierte Konvertierungsrichtlinie begrenzt, was ein nicht authentifizierter Aufrufer vor dem Erstellen eines Jobs verändern darf.

Drei URL-Typen

Signierte Uploads autorisieren ein File, signierte Downloads temporären Output-Zugriff und signierte Konvertierungen einen eingeschränkten Workflow ohne Offenlegung des API-Schlüssels.

Konvertierungsrichtlinien

Eine Signed-URL-Base erzwingt Ablauf und kann Quellhosts, Dateigröße, Credits, Nutzungen und Workflow-Version begrenzen. Das Base-Secret kann unabhängig von API-Schlüsseln rotiert werden.

Validierte Variablen

Eine signierte URL darf nur vom Workflow-Schema deklarierte Variablen liefern. Typen, Pflichtfelder, Enums, Grenzen und Patterns werden vor dem Rendern des Jobs validiert.

Caching

Ein optionaler cache_key kann gültige Outputs wiederverwenden und redundante Verarbeitung vermeiden.