ConverterHQDevelopers
API v1

SDKs et téléchargements

Clients officiels REST/cURL, Python, JavaScript, TypeScript, Go, Java, C#/.NET, C++, Rust, PHP, Ruby.

Chaque SDK combine un transport généré depuis OpenAPI avec une couche ergonomique écrite pour le langage.

Langages officiels

REST/cURL, Python, JavaScript, TypeScript, Go, Java, C#/.NET, C++, Rust, PHP, Ruby couvrent conversions, Files, Jobs, uploads multipart, erreurs typées, webhooks et temps réel.

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

Conception des SDK

Les méthodes de haut niveau masquent le polling, le choix upload simple/multipart et le téléchargement tout en laissant l’accès aux ressources REST avancées.

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

La CLI officielle permet conversions, upload de Files, gestion de Jobs, découverte de formats et écoute locale des webhooks avec sorties humaines ou JSON.

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