Toolorah API

Démarrage rapide

Chaque outil utilise l’endpoint indiqué ci-dessous. Envoyez votre clé API comme jeton bearer et un corps JSON contenant input et options. Voici le même appel dans trois langages : 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=

Authentification

Créez une clé sur la page des clés API, puis envoyez-la comme jeton bearer avec chaque requête : Obtenir une clé API

Authorization: Bearer nt_live_xxxxxxxxxxxxxxxx

Les clés disposent des autorisations du forfait avec lequel elles ont été créées. Traitez-les comme des mots de passe : conservez-les côté serveur et révoquez toute clé exposée depuis la page des clés.

Requêtes et réponses

Tous les endpoints utilisent POST et acceptent un corps JSON avec deux champs :

• input — le texte (ou le fichier base64 pour les outils PDF) à traiter.
• options — un objet de paramètres propre à l’outil. Facultatif ; des valeurs par défaut adaptées sont utilisées.

Un appel réussi renvoie 200 avec cette structure :

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

Les erreurs renvoient un statut autre que 2xx avec un seul champ error :

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

Limites de débit

• Pro — 1 000 appels/jour
• Elite — 10 000 appels/jour

Les limites sont réinitialisées à 00:00 UTC. Chaque réponse indique votre budget actuel :

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

Une fois la limite dépassée, les appels renvoient 429 avec un en-tête Retry-After. Les requêtes mal formées ne sont pas décomptées.

Endpoints

Outils de texte et utilitaires. Utilisez les options indiquées pour contrôler leur comportement.

Endpoints PDF

Les outils PDF traitent des fichiers. Les requêtes contiennent les fichiers encodés en base64 dans le JSON et result contient le PDF de sortie en base64. Gardez la charge décodée sous environ 4 Mo. WebP est réservé au navigateur ; envoyez du PNG ou du 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

Erreurs

• 401 — clé API absente ou invalide
• 403 — votre forfait ne donne pas accès à l’API
• 404 — outil inconnu
• 422 — entrée incorrecte (par exemple JSON ou regex invalide)
• 429 — limite quotidienne atteinte