ConverterHQDevelopers
API v1

Szybki start

Wykonaj pierwszą konwersję przez API ConverterHQ w kilka minut.

ConverterHQ jest prosty dla pojedynczego pliku, a później skaluje się do pełnych workflow bez zmiany silnika wykonawczego.

Od żądania do wyniku
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.