ConverterHQDevelopers
API v1

Cloudopslag

Importeer uit en exporteer naar S3, GCS, Azure Blob en SFTP met herbruikbare Connections.

Connections houden providercredentials buiten Jobs en maken server-to-server transfers mogelijk. Externe imports worden vóór conversie genormaliseerd naar een ConverterHQ-owned File; outputs kunnen naar elke ondersteunde provider.

Cloud-naar-cloud-conversie
Input provider
ConverterHQ File
Conversion
Output provider
Externe invoer wordt eerst naar een ConverterHQ-owned File gekopieerd; uitvoer kan naar elke ondersteunde provider.

Connections

Secrets zijn versleuteld en worden nooit teruggegeven. Test POST /v1/connections/{id}/test voor productie en roteer of revoke een Connection in plaats van secrets in Jobs te kopiëren.

Canonieke input

import/s3, import/gcs, import/azure en import/sftp halen de bron op en bewaren die als ConverterHQ File. Conversie-Tasks lezen dit owned File zodat retries, retentie, checksums en ownership consistent zijn.

Multi-cloud outputs

Resultaten zijn ConverterHQ Files en kunnen via export/s3, export/gcs, export/azure of export/sftp worden geleverd. Input- en outputprovider hoeven niet gelijk te zijn.

S3-beveiliging

Gebruik voor S3 bij voorkeur AssumeRole met ExternalId en beperk de rol tot noodzakelijke buckets en prefixes.

Import/export Tasks

Het DAG-contract blijft gelijk: imports produceren Files en exports consumeren Files. Externe export-side-effects worden gecheckpoint zodat een onzeker resultaat niet stilzwijgend opnieuw wordt uitgevoerd.

Foutafhandeling

Authenticatiefouten, ontbrekende objecten en permissies blijven deterministisch tot externe toestand verandert. Inspecteer de Task-fout en test de Connection voor een retry.