ConverterHQ jest prosty dla pojedynczego pliku, a później skaluje się do pełnych workflow bez zmiany silnika wykonawczego.
AppFile / URL
ConverterHQ APIValidation
JobTasks
Output FileSigned download
Szybkie żądania mogą zakończyć się w oknie oczekiwania; dłuższa praca trwa w tym samym trwałym Job.
Pierwsza konwersja
Utwórz klucz testowy, wyślij plik i wybierz format wyjściowy. Oficjalne SDK automatyzują oczekiwanie i pobranie wyniku.
from converterhq import ConverterHQ
# Reads CONVERTERHQ_API_KEY. hq_test_* keys automatically use the sandbox.
client = ConverterHQ()
result = client.convert(
"report.docx",
from_format="docx",
to="pdf",
wait=20,
)
result.save("report.pdf")Gdy przetwarzanie staje się asynchroniczne
Szybkie żądanie może zakończyć się w oknie oczekiwania; w przeciwnym razie API zwraca 202 i trwały Job do pollingu lub webhooków.
Co dalej
Używaj Files dla dużych plików, Jobs i Tasks dla workflow oraz podpisanych webhooków w automatyzacji produkcyjnej.