Toolorah API

Schnellstart

Jedes Tool verwendet den unten angegebenen Endpunkt. Sende deinen API-Schlüssel als Bearer-Token und einen JSON-Body mit input und options. Hier ist derselbe Aufruf in drei Sprachen: POST /api/v1/<tool> { input, options }

curl -X POST https://www.toolorah.com/api/v1/base64 \
  -H "Authorization: Bearer nt_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"input":"hello world","options":{"mode":"encode"}}'

const res = await fetch("https://www.toolorah.com/api/v1/base64", {
  method: "POST",
  headers: {
    "Authorization": "Bearer nt_live_xxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ input: "hello world", options: { mode: "encode" } }),
});
const data = await res.json();
console.log(data.result); // "aGVsbG8gd29ybGQ="

import requests

res = requests.post(
    "https://www.toolorah.com/api/v1/base64",
    headers={"Authorization": "Bearer nt_live_xxx"},
    json={"input": "hello world", "options": {"mode": "encode"}},
)
print(res.json()["result"])  # aGVsbG8gd29ybGQ=

Authentifizierung

Erstelle auf der Seite API-Schlüssel einen Schlüssel und sende ihn bei jeder Anfrage als Bearer-Token: API-Schlüssel abrufen

Authorization: Bearer nt_live_xxxxxxxxxxxxxxxx

Schlüssel besitzen die Berechtigungen des Tarifs, unter dem sie erstellt wurden. Behandle sie wie Passwörter: Bewahre sie serverseitig auf und widerrufe offengelegte Schlüssel auf der Schlüsselseite.

Anfragen und Antworten

Alle Endpunkte verwenden POST und akzeptieren einen JSON-Body mit zwei Feldern:

• input — der zu verarbeitende Text (oder bei PDF-Tools eine Base64-Datei).
• options — ein toolspezifisches Einstellungsobjekt. Optional; sinnvolle Standardwerte werden angewendet.

Ein erfolgreicher Aufruf gibt 200 mit dieser Struktur zurück:

{
  "tool": "base64",
  "result": "aGVsbG8gd29ybGQ=",
  "meta": { }
}

Fehler geben einen Nicht-2xx-Status mit einem einzelnen error-Feld zurück:

{ "error": "Invalid or revoked API key." }

Ratenlimits

• Pro — 1.000 Aufrufe/Tag
• Elite — 10.000 Aufrufe/Tag

Limits werden um 00:00 UTC zurückgesetzt. Jede Antwort enthält dein aktuelles Budget:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 942

Nach Überschreiten des Limits geben Aufrufe 429 mit einem Retry-After-Header zurück. Fehlerhafte Anfragen zählen nicht zum Kontingent.

Batch-Anfragen

Verarbeite viele Eingaben in einer einzigen Anfrage, statt pro Element einen HTTP-Aufruf zu schleifen. Sende inputs als Array von Strings; options gilt für jedes Element. Verfügbar in Pro (25 Eingaben pro Anfrage) und Elite (250).

curl -X POST https://www.toolorah.com/api/v1/base64/batch   -H "Authorization: Bearer nt_live_..."   -H "Content-Type: application/json"   -d '{"inputs":["hello","world"],"options":{"mode":"encode"}}'

{
  "tool": "base64",
  "count": 2,
  "succeeded": 2,
  "failed": 0,
  "results": [
    { "index": 0, "result": "aGVsbG8=" },
    { "index": 1, "result": "d29ybGQ=" }
  ]
}

Jede Eingabe kostet einen Aufruf deines Tageskontingents — Batches sparen Roundtrips, kein Kontingent. Ein Batch, der dein Tageslimit überschreiten würde, wird komplett abgelehnt und nichts wird verarbeitet, du erhältst also nie ein halbfertiges Ergebnis.

Die Ergebnisse kommen in derselben Reihenfolge wie die Eingaben zurück, jeweils mit ihrem index. Eine fehlerhafte Eingabe verwirft die übrigen nicht: Für diesen Index wird ein error-Feld zurückgegeben, während alle anderen Ergebnisse gelingen. Prüfe succeeded und failed in der Antwort.

Hilfs-Endpunkte

Zwei GET-Endpunkte, um herauszufinden, was du aufrufen kannst und wie viel Kontingent dir bleibt. Beide benötigen denselben Bearer-Schlüssel.

{
  "plan": "pro",
  "daily": { "limit": 1000, "used": 42, "remaining": 958 },
  "batch": { "maxInputsPerRequest": 25 },
  "resetsAt": "2026-08-24T00:00:00.000Z"
}

Endpunkte

Text- und Hilfstools. Steuere das Verhalten über die aufgeführten options.

PDF-Endpunkte

PDF-Tools arbeiten mit Dateien. Anfragen enthalten Base64-Dateien im JSON und result enthält das Ausgabe-PDF als Base64. Die dekodierte Nutzlast sollte unter etwa 4 MB bleiben. WebP funktioniert nur im Browser; sende PNG oder JPG.

# Merge two PDFs (bash)
curl -X POST https://www.toolorah.com/api/v1/pdf-merger \
  -H "Authorization: Bearer nt_live_xxx" \
  -H "Content-Type: application/json" \
  -d "{\"files\":[\"$(base64 -w0 a.pdf)\",\"$(base64 -w0 b.pdf)\"]}" \
  | jq -r '.result' | base64 -d > merged.pdf

Fehler

• 401 — fehlender oder ungültiger API-Schlüssel
• 403 — dein Tarif enthält keinen API-Zugriff
• 404 — unbekanntes Tool
• 422 — ungültige Eingabe (zum Beispiel fehlerhaftes JSON oder Regex)
• 429 — Tageslimit erreicht