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://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://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://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.

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://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