ConverterHQDevelopers
API v1

Armazenamento em nuvem

Importe de e exporte para S3, GCS, Azure Blob e SFTP com Connections reutilizáveis.

Connections mantêm credenciais do provedor fora de Jobs e permitem transferências servidor a servidor. Imports externos são normalizados em um File do ConverterHQ antes da conversão; outputs podem ser entregues a qualquer provedor compatível.

Conversão entre nuvens
Input provider
ConverterHQ File
Conversion
Output provider
Entradas externas são primeiro copiadas para um File controlado pelo ConverterHQ; saídas podem usar qualquer provedor suportado.

Connections

Segredos são criptografados e nunca retornados. Teste POST /v1/connections/{id}/test antes da produção e rotacione ou revogue a Connection em vez de copiar segredos para Jobs.

Entrada canônica

import/s3, import/gcs, import/azure e import/sftp obtêm a fonte e persistem um File do ConverterHQ. Tasks de conversão leem esse File, unificando retries, retenção, checksums e ownership.

Outputs multi-cloud

Resultados são Files do ConverterHQ e podem ser exportados com export/s3, export/gcs, export/azure ou export/sftp. O provedor de entrada e saída pode ser diferente.

Segurança S3

Para S3, prefira AssumeRole com ExternalId e limite a role aos buckets e prefixos necessários.

Tasks de import/export

O contrato DAG é consistente: imports produzem Files e exports consomem Files. Efeitos externos são checkpointados para não repetir silenciosamente um export incerto.

Tratamento de falhas

Falhas de autenticação, objetos ausentes e permissões são determinísticos até o estado externo mudar. Inspecione o erro da Task e teste a Connection antes de tentar novamente.