ConverterHQDevelopers
API v1

Platform mimarisi

Control plane, data plane, storage, durable Jobs ve event modelini anlayın.

ConverterHQ API koordinasyonu, byte transferi ve converter yürütmesini ayırır; büyük dosya ve uzun Jobs ilk HTTP request’ten bağımsız devam eder.

Kalıcı yürütme mimarisi
Client
Control plane
Files
Jobs + Tasks
Delivery
Binary transfer ve dönüşüm yürütmesi, ilk HTTP isteğinin ömründen bağımsızdır.

Control ve data plane

API doğrular, capabilities/settings kontrol eder ve Files, Jobs, Tasks kaydeder. Byte’lar signed object storage’a gider; worker kuyruktaki Tasks’i yürütür.

Kaynak modeli

Files durable binary asset’tir. Jobs, Tasks DAG’ı taşır; attempts fiziksel history’yi korur. Workflows grafikleri version’lar, Connections cloud secrets’i izole eder.

Yürütme lifecycle

REST otoritatif state’tir. Webhooks durable at-least-once delivery sağlar; WebSocket/SSE realtime progress projeksiyonudur.

Tasarım sonuçları

Resource ID’leri persist edin, Idempotency-Key kullanın, büyük dosyaları direkt yükleyin ve üretim otomasyonunu Jobs + webhooks üzerine kurun.