ConverterHQDevelopers
API v1

Stockage cloud

Importez depuis et exportez vers S3, GCS, Azure Blob et SFTP avec des Connections réutilisables.

Les Connections gardent les identifiants fournisseur hors des Jobs et permettent des transferts serveur-à-serveur. Un import externe est normalisé en File appartenant à ConverterHQ avant la conversion; la sortie peut ensuite être livrée vers n’importe quel fournisseur pris en charge.

Conversion cloud à cloud
Input provider
ConverterHQ File
Conversion
Output provider
Les entrées externes sont d’abord copiées dans un File contrôlé par ConverterHQ; les sorties peuvent viser tout fournisseur pris en charge.

Connexions

Les secrets sont chiffrés et jamais retournés par l’API. Testez POST /v1/connections/{id}/test avant un Workflow de production et faites tourner ou révoquez la Connection plutôt que de copier des secrets dans les Jobs.

Entrée canonique

import/s3, import/gcs, import/azure et import/sftp récupèrent d’abord la source puis la persistent comme File ConverterHQ. Les Tasks de conversion lisent ce File détenu afin que retries, rétention, checksums et ownership restent cohérents.

Sorties multi-cloud

Les résultats sont des Files ConverterHQ exportables avec export/s3, export/gcs, export/azure ou export/sftp. Les fournisseurs d’entrée et de sortie peuvent être différents.

Sécurité S3

Pour S3, préférez AssumeRole avec ExternalId aux clés longue durée et limitez le rôle aux buckets et préfixes strictement nécessaires.

Tasks import/export

Le contrat DAG reste identique entre fournisseurs: les imports produisent des Files et les exports consomment des Files. Les effets externes d’export sont checkpointés pour éviter une répétition silencieuse après un résultat incertain.

Gestion des erreurs

Les erreurs d’authentification, objets absents et permissions restent déterministes tant que l’état externe ne change pas. Inspectez l’erreur Task et testez la Connection avant de réessayer.