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.
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.