ConverterHQDevelopers
API v1

Penyimpanan cloud

Import dari dan export ke S3, GCS, Azure Blob, dan SFTP dengan Connections yang dapat digunakan ulang.

Connections menjaga credential provider di luar Job dan memungkinkan transfer server-to-server. Import eksternal dinormalisasi menjadi File milik ConverterHQ sebelum konversi; output dapat dikirim ke provider mana pun yang didukung.

Konversi antar-cloud
Input provider
ConverterHQ File
Conversion
Output provider
Input eksternal lebih dulu disalin ke File milik ConverterHQ; output dapat dikirim ke provider mana pun yang didukung.

Connections

Secret dienkripsi dan tidak pernah dikembalikan. Uji POST /v1/connections/{id}/test sebelum produksi dan rotasi atau cabut Connection daripada menyalin secret ke Job.

Input kanonik

import/s3, import/gcs, import/azure, dan import/sftp mengambil sumber lalu menyimpannya sebagai File ConverterHQ. Task konversi membaca File ini agar retry, retensi, checksum, dan ownership konsisten.

Output multi-cloud

Hasil adalah File ConverterHQ yang dapat diekspor dengan export/s3, export/gcs, export/azure, atau export/sftp. Provider input dan output tidak harus sama.

Keamanan S3

Untuk S3, utamakan AssumeRole dengan ExternalId dan batasi role ke bucket serta prefix yang diperlukan.

Import/export Tasks

Kontrak DAG konsisten: import menghasilkan File dan export menggunakan File. Side effect eksternal dicheckpoint agar export dengan hasil tidak pasti tidak diulang diam-diam.

Penanganan kegagalan

Error autentikasi, objek hilang, dan izin bersifat deterministik sampai kondisi eksternal berubah. Periksa error Task dan uji Connection sebelum retry.