ConverterHQDevelopers
API v1

Cloud-Speicher

Importieren Sie aus und exportieren Sie nach S3, GCS, Azure Blob und SFTP mit wiederverwendbaren Connections.

Connections halten Provider-Credentials aus Job-Payloads heraus und ermöglichen Server-zu-Server-Transfers. Externe Imports werden vor der Konvertierung in ein ConverterHQ-eigenes File normalisiert; Outputs können an jeden unterstützten Provider geliefert werden.

Cloud-zu-Cloud-Konvertierung
Input provider
ConverterHQ File
Conversion
Output provider
Externe Eingaben werden vor der Konvertierung in ein eigenes File übernommen; Ausgaben können an jeden unterstützten Provider gehen.

Connections

Secrets werden verschlüsselt und nie von der API zurückgegeben. Testen Sie POST /v1/connections/{id}/test vor Produktions-Workflows und rotieren oder widerrufen Sie Connections statt Secrets in Jobs zu kopieren.

Kanonisches Input-Staging

import/s3, import/gcs, import/azure und import/sftp laden die Quelle zunächst und speichern sie als eigenes ConverterHQ-File. Konvertierungs-Tasks lesen dieses File, damit Retries, Retention, Checksums und Ownership einheitlich bleiben.

Multi-Cloud-Outputs

Ergebnisse sind ConverterHQ-Files und lassen sich mit export/s3, export/gcs, export/azure oder export/sftp ausliefern. Input- und Output-Provider müssen nicht übereinstimmen.

S3-Sicherheit

Für S3 bevorzugen Sie AssumeRole mit ExternalId und beschränken die Rolle auf benötigte Buckets und Präfixe.

Import-/Export-Tasks

Der DAG-Vertrag bleibt providerübergreifend gleich: Imports erzeugen Files, Exports konsumieren Files. Externe Export-Effekte werden checkpointed, damit ein unsicheres Ergebnis nicht unbemerkt wiederholt wird.

Fehlerbehandlung

Authentifizierungsfehler, fehlende Objekte und Berechtigungsfehler bleiben deterministisch, bis sich der externe Zustand ändert. Prüfen Sie den Task-Fehler und testen Sie die Connection vor einem Retry.