Ga naar hoofdinhoud
Converty

Ontwikkelaars-API

Programmatische toegang tot Converty server-side conversies.

De v1 API gebruikt dezelfde conversiepipeline als de webapp. U heeft een API-sleutel nodig voor uw project.

Authenticatie

Stuur uw API-sleutel mee bij elk verzoek:

Authorization: Bearer YOUR_API_KEY
# or
X-API-Key: YOUR_API_KEY

Endpoints

Basis-URL: https://api.example.com

  • GET /v1 — API-metadata (geen sleutel vereist)
  • POST /v1/convert/document — PDF, Word, Excel, …
  • POST /v1/convert/audio — audio · video · image · archive · ebook · 3d
  • GET /progress/:jobId — Server-Sent Events stream
  • GET /download/:jobId?token=… — Ondertekende download
  • POST /import/url — Extern bestand ophalen (JSON-body { "url": "…" })

Categorieën: document · audio · video · image · archive · ebook · 3d

Typische flow

  1. POST multipart-formulier naar /v1/convert/{category} met file, from, to en options JSON.
  2. Ontvang { jobId, estimatedSeconds }.
  3. Abonneer op GET /progress/{jobId} (SSE) voor live status.
  4. Download via de ondertekende URL in het complete-event.
curl -X POST "https://api.example.com/v1/convert/document" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.pdf" \
  -F "from=pdf" \
  -F "to=docx" \
  -F 'options={}'

Limieten

Standaard rate limits gelden per IP. Bestanden moeten overeenkomen met ondersteunde formaatparen. Zie converterregistry voor geldige from/to-waarden.

Hogere limieten of dedicated key nodig? Neem contact op.