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

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.

Requêtes par lot

Traitez plusieurs entrées en une seule requête au lieu de boucler un appel HTTP par élément. Envoyez inputs sous forme de tableau de chaînes ; options s'applique à chaque élément. Disponible sur Pro (25 entrées par requête) et 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=" }
  ]
}

Chaque entrée consomme un appel de votre quota quotidien : les lots économisent des allers-retours, pas du quota. Un lot qui dépasserait votre limite quotidienne est refusé en entier et rien n'est traité, vous ne recevez donc jamais un ensemble de résultats incomplet.

Les résultats reviennent dans le même ordre que les entrées, chacun étiqueté avec son index. Une entrée incorrecte n'annule pas les autres : elle renvoie un champ error pour cet index tandis que tous les autres résultats aboutissent. Vérifiez succeeded et failed dans la réponse.

Endpoints utilitaires

Deux endpoints GET pour découvrir ce que vous pouvez appeler et le quota qu'il vous reste. Les deux nécessitent la même clé bearer.

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

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

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