Naar hoofdinhoud
open-toolsopen-tools

API

open-tools API

Programmatische toegang tot al onze tools. Gebruik het om grote PDF- of beeldtaken in je eigen pipelines te integreren.

Snel starten

  1. Maak een account aan als je er nog geen hebt.
  2. Maak een API-sleutel aan via Account → API-sleutels. Het volledige token wordt eenmaliggetoond; kopieer het nu.
  3. Stuur het token mee als Authorization: Bearer otk_… bij elk verzoek.

Referentie

De volledige OpenAPI-specificatie — elk endpoint, elke parameter, elke responsstructuur — wordt automatisch gegenereerd vanuit de FastAPI-app en geserveerd als JSON. Zowel Swagger UI als ReDoc kunnen het weergeven.

Open de interactieve API-referentie →

Liever de ruwe spec of een live console? De machineleesbare OpenAPI JSON en de Swagger- / ReDoc-verkenners zijn beschikbaar voor ingelogde accounts:

Voorbeeld — een PDF splitsen

Upload een bestand en peil het resultaat:

# 1. Upload and create the job
curl -X POST 'https://api.open-tools.app/api/upload' \
  -H 'Authorization: Bearer otk_YOUR_KEY' \
  -F 'file=@input.pdf' \
  -F 'job_type=pdf-split' \
  -F 'parameters={"pages": "1-3"}'
# → {"job_id": "abc123", "status": "queued", "ws_token": "..."}

# 2. Poll job status (or subscribe via WebSocket /ws/<job_id>?token=<ws_token>)
curl 'https://api.open-tools.app/api/jobs/abc123' \
  -H 'Authorization: Bearer otk_YOUR_KEY'
# → {"status": "completed", "output_file_url": "https://api.open-tools.app/api/download/users/42/..."}

# 3. Download the result
curl -o output.pdf 'https://api.open-tools.app/api/download/users/42/<uuid>.pdf' \
  -H 'Authorization: Bearer otk_YOUR_KEY'

Foutcodes

Alle fouten hebben dezelfde envelopstructuur:

{
  "detail": {
    "error": {
      "code": "INVALID_FILE_TYPE",
      "message": "image-resize requires PNG, JPG, or WEBP.",
      "details": { "expected_extensions": [".png", ".jpg", ".webp"] }
    }
  }
}
HTTPCodeBetekenis
400INVALID_FILE_TYPEBestandsextensie staat niet op de acceptatielijst van deze taak.
400INVALID_FILE_SIGNATUREMagic bytes komen niet overeen met de extensie.
400INVALID_PARAMETERSDe parameters JSON heeft de schemavalidatie niet doorstaan.
401AUTH_REQUIREDGeen sessiecookie of API-sleutel bij het verzoek.
403REAUTH_REQUIREDGevoelige actie; sessie ouder dan 15 minuten.
413FILE_TOO_LARGEUpload overschrijdt het maximum van 50 MB.
429RATE_LIMITEDTierlimiet overschreden. Zie Retry-After.
500INTERNAL_ERRORBug. Voeg de request_id header toe.

Limieten & gebruik

Elk account heeft per-minuut-, per-uur-, per-dag- en per-maandbuckets. Het huidige gebruik is zichtbaar op je accountdashboard. Een 429 gekregen? Wacht tot het venster schuift; de respons bevatRetry-After seconden.