ConverterHQDevelopers
API v1

SDK dan unduhan

Klien resmi untuk REST/cURL, Python, JavaScript, TypeScript, Go, Java, C#/.NET, C++, Rust, PHP, Ruby.

Setiap SDK menggabungkan transport yang dihasilkan dari OpenAPI dengan lapisan convenience idiomatik yang ditulis manual.

Bahasa resmi

REST/cURL, Python, JavaScript, TypeScript, Go, Java, C#/.NET, C++, Rust, PHP, Ruby mendukung konversi, Files, Jobs, multipart, typed errors, webhook, dan realtime.

cURL

REST
Source package

Canonical raw HTTP starter. No runtime dependency.

Package
HTTP API v1
Registry
Publication pending verification
Install from downloaded source
tar -xzf converterhq-curl-starter.tar.gz
cd sdks/curl
./quickstart.sh report.docx

Python

Python 3.10+
Source package

Official source SDK with CLI and webhook verification.

Package
converterhq
Registry
Publication pending verification
Install from downloaded source
tar -xzf converterhq-python-sdk.tar.gz
pip install ./sdks/python

JavaScript

Node.js
Source package

JavaScript and TypeScript share the official Node SDK.

Package
@converterhq/sdk
Registry
Publication pending verification
Install from downloaded source
tar -xzf converterhq-javascript-sdk.tar.gz
npm install ./sdks/typescript

TypeScript

Node.js + types
Source package

Typed Node client generated against the same API v1 contract.

Package
@converterhq/sdk
Registry
Publication pending verification
Install from downloaded source
tar -xzf converterhq-typescript-sdk.tar.gz
npm install ./sdks/typescript

Go

Go module
Source package

Context-aware client, direct uploads and webhook verification.

Package
github.com/converterhq/converterhq-go
Registry
Publication pending verification
Install from downloaded source
tar -xzf converterhq-go-sdk.tar.gz
go mod edit -replace github.com/converterhq/converterhq-go=./sdks/go

Java

JDK / Maven
Source package

Source SDK packaged as a Maven project while registry publication is pending.

Package
io.converterhq:converterhq-java
Registry
Publication pending verification
Install from downloaded source
tar -xzf converterhq-java-sdk.tar.gz
mvn -f sdks/java/pom.xml install

C# / .NET

.NET
Source package

Async .NET client with webhook helpers.

Package
ConverterHQ
Registry
Publication pending verification
Install from downloaded source
tar -xzf converterhq-csharp-sdk.tar.gz
dotnet build sdks/dotnet/ConverterHQ/ConverterHQ.csproj

C++

CMake
Source package

Source-first CMake package; no registry dependency required.

Package
ConverterHQ CMake package
Registry
Publication pending verification
Install from downloaded source
tar -xzf converterhq-cpp-sdk.tar.gz
cmake -S sdks/cpp -B build && cmake --build build

Rust

Cargo
Source package

Async Rust client with direct upload and webhook support.

Package
converterhq
Registry
Publication pending verification
Install from downloaded source
tar -xzf converterhq-rust-sdk.tar.gz
cargo test --manifest-path sdks/rust/Cargo.toml

PHP

Composer
Source package

Composer-ready source artifact while Packagist publication is pending.

Package
converterhq/converterhq-php
Registry
Publication pending verification
Install from downloaded source
tar -xzf converterhq-php-sdk.tar.gz
composer install --working-dir=sdks/php

Ruby

RubyGems
Source package

Gem source with conversion and webhook clients.

Package
converterhq
Registry
Publication pending verification
Install from downloaded source
tar -xzf converterhq-ruby-sdk.tar.gz
gem build sdks/ruby/converterhq.gemspec

Desain SDK

Metode high-level menyembunyikan polling, pemilihan upload, dan download tanpa membatasi akses ke resource REST lanjutan.

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")

CLI

CLI menyediakan konversi, upload File, pengelolaan Job, format discovery, dan listener webhook lokal dengan output human atau JSON.

CLI
converterhq convert report.docx --to pdf
converterhq jobs wait job_...
converterhq formats outputs docx
converterhq webhook listen