ConverterHQDevelopers
API v1

Storage cloud

Importa da ed esporta verso S3, GCS, Azure Blob e SFTP con Connections riutilizzabili.

Le Connections tengono le credenziali del provider fuori dai Jobs e consentono trasferimenti server-to-server. Gli import esterni vengono normalizzati in un File di ConverterHQ prima della conversione; gli output possono essere consegnati a qualsiasi provider supportato.

Conversione cloud-to-cloud
Input provider
ConverterHQ File
Conversion
Output provider
Gli input esterni vengono prima copiati in un File controllato da ConverterHQ; gli output possono usare qualsiasi provider supportato.

Connections

I secret sono cifrati e non vengono mai restituiti. Testa POST /v1/connections/{id}/test prima della produzione e ruota o revoca una Connection invece di copiare secret nei Jobs.

Input canonico

import/s3, import/gcs, import/azure e import/sftp recuperano la sorgente e la persistono come File ConverterHQ. Le Tasks di conversione leggono questo File per uniformare retry, retention, checksum e ownership.

Output multi-cloud

I risultati sono Files ConverterHQ esportabili con export/s3, export/gcs, export/azure o export/sftp. Provider di input e output possono essere diversi.

Sicurezza S3

Per S3 preferisci AssumeRole con ExternalId e limita il ruolo ai bucket e prefissi necessari.

Tasks import/export

Il contratto DAG resta coerente: gli import producono Files e gli export consumano Files. Gli effetti esterni vengono checkpointed per evitare di ripetere in silenzio un export dal risultato incerto.

Gestione errori

Errori di autenticazione, oggetti mancanti e permessi sono deterministici finché lo stato esterno non cambia. Ispeziona l’errore Task e testa la Connection prima del retry.