ConverterHQDevelopers
API v1

Pamięć chmurowa

Importuj z i eksportuj do S3, GCS, Azure Blob oraz SFTP przez wielokrotnego użytku Connections.

Connections utrzymują credentials dostawcy poza Jobs i umożliwiają transfer server-to-server. Zewnętrzny import jest normalizowany do File należącego do ConverterHQ przed konwersją; output może trafić do dowolnego wspieranego providera.

Konwersja między chmurami
Input provider
ConverterHQ File
Conversion
Output provider
Zewnętrzne wejście jest najpierw kopiowane do File należącego do ConverterHQ; wyjście może trafić do dowolnego obsługiwanego dostawcy.

Connections

Secrets są szyfrowane i nigdy nie są zwracane. Testuj POST /v1/connections/{id}/test przed produkcją i rotuj lub unieważniaj Connection zamiast kopiować sekrety do Jobs.

Kanoniczny input

import/s3, import/gcs, import/azure i import/sftp pobierają źródło i zapisują je jako ConverterHQ File. Tasks konwersji czytają ten owned File, ujednolicając retries, retencję, checksums i ownership.

Multi-cloud outputs

Wyniki są ConverterHQ Files eksportowanymi przez export/s3, export/gcs, export/azure lub export/sftp. Provider wejścia i wyjścia nie musi być ten sam.

Bezpieczeństwo S3

Dla S3 preferuj AssumeRole z ExternalId i ogranicz rolę do wymaganych bucketów i prefiksów.

Tasks import/export

Kontrakt DAG jest spójny: importy produkują Files, eksporty je konsumują. Zewnętrzne side effects są checkpointowane, aby nie powtarzać po cichu eksportu o niepewnym wyniku.

Obsługa błędów

Błędy uwierzytelnienia, brak obiektu i permissions są deterministyczne do zmiany stanu zewnętrznego. Sprawdź błąd Task i przetestuj Connection przed retry.