ConverterHQDevelopers
API v1

URLs signées

Uploads, téléchargements et conversions signés sans exposer de clé API.

ConverterHQ distingue les URLs de stockage signées des URLs de conversion signées qui peuvent lancer un Workflow sous une politique limitée.

Conversion régie par une politique
Client
Signed URLExpiry + policy
Workflow Job
Output
La politique de conversion signée limite ce qu’un appelant non authentifié peut modifier avant la création d’un Job.

Trois types d’URL

Les uploads signés autorisent un File, les téléchargements signés autorisent temporairement une sortie et les conversions signées lancent un Workflow contraint sans révéler de clé API.

Politiques de conversion

Une base signée impose une expiration et peut limiter les domaines source, taille, crédits, nombre d’utilisations et version de Workflow. Son secret peut être renouvelé sans changer les clés API permanentes.

Variables validées

Une URL signée ne peut fournir que les variables déclarées par le schéma du Workflow. Types, champs requis, enums, limites et patterns sont validés avant le rendu du Job.

Cache

Un cache_key facultatif peut réutiliser une sortie encore valide et éviter un traitement redondant.