ConverterHQDevelopers
API v1

Bulut depolama

Yeniden kullanılabilir Connections ile S3, GCS, Azure Blob ve SFTP’den import edin ve bu hedeflere export edin.

Connections provider kimlik bilgilerini Jobs dışında tutar ve server-to-server transfer sağlar. Harici import, dönüşümden önce ConverterHQ’nun sahip olduğu bir File’a normalize edilir; output desteklenen herhangi bir provider’a gönderilebilir.

Buluttan buluta dönüşüm
Input provider
ConverterHQ File
Conversion
Output provider
Harici girdiler önce ConverterHQ’ya ait bir File’a kopyalanır; çıktılar desteklenen herhangi bir sağlayıcıya gönderilebilir.

Connections

Secret’lar şifrelenir ve API tarafından geri verilmez. Production öncesi POST /v1/connections/{id}/test kullanın; secret’ı Job’a kopyalamak yerine Connection’ı rotate veya revoke edin.

Kanonik input staging

import/s3, import/gcs, import/azure ve import/sftp kaynağı alır ve ConverterHQ File olarak saklar. Conversion Tasks bu owned File’ı okuyarak retry, retention, checksum ve ownership sınırını tutarlı hale getirir.

Multi-cloud outputs

Sonuçlar export/s3, export/gcs, export/azure veya export/sftp ile gönderilebilen ConverterHQ Files’dır. Input ve output provider aynı olmak zorunda değildir.

S3 güvenliği

S3 için uzun süreli key yerine ExternalId ile AssumeRole tercih edin ve role’ü yalnız gerekli bucket/prefix’lerle sınırlayın.

Import/export Tasks

DAG contract provider’lar arasında aynıdır: import Files üretir, export Files tüketir. Harici export side effect’leri checkpoint edilerek belirsiz sonuç sessizce tekrarlanmaz.

Hata yönetimi

Authentication, missing object ve permission hataları dış durum değişene kadar deterministiktir. Retry öncesi Task error’u inceleyin ve Connection’ı test edin.