Toolorah API

Inicio rápido

Cada herramienta utiliza el endpoint indicado abajo. Envía tu clave de API como token bearer y un cuerpo JSON con input y options. Esta es la misma llamada en tres lenguajes: 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=

Autenticación

Crea una clave en la página de claves de API y envíala como token bearer en cada solicitud: Obtener clave de API

Authorization: Bearer nt_live_xxxxxxxxxxxxxxxx

Las claves tienen los permisos del plan con el que fueron creadas. Trátalas como contraseñas: guárdalas en el servidor y revoca desde la página de claves cualquier clave expuesta.

Solicitudes y respuestas

Todos los endpoints usan POST y aceptan un cuerpo JSON con dos campos:

• input — el texto (o archivo base64 para herramientas PDF) que se procesará.
• options — un objeto de configuración específico de la herramienta. Es opcional y se aplican valores predeterminados razonables.

Una llamada correcta devuelve 200 con esta estructura:

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

Los errores devuelven un estado distinto de 2xx con un único campo error:

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

Límites de uso

• Pro — 1.000 llamadas/día
• Elite — 10.000 llamadas/día

Los límites se reinician a las 00:00 UTC. Cada respuesta incluye el saldo actual:

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

Al superar el límite, las llamadas devuelven 429 con una cabecera Retry-After. Las solicitudes mal formadas no consumen cuota.

Endpoints

Herramientas de texto y utilidades. Usa las options indicadas para controlar el comportamiento.

Endpoints de PDF

Las herramientas PDF trabajan con archivos. Las solicitudes llevan archivos codificados en base64 dentro del JSON y result contiene el PDF de salida en base64. Mantén la carga decodificada por debajo de unos 4 MB. WebP solo funciona en el navegador; envía PNG o 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

Errores

• 401 — clave de API ausente o no válida
• 403 — tu plan no incluye acceso a la API
• 404 — herramienta desconocida
• 422 — entrada incorrecta (por ejemplo, JSON o regex no válidos)
• 429 — límite diario alcanzado