Référence de l'API Toolty

L'API est en REST sur HTTPS, avec des corps JSON. Les fichiers ne passent jamais par l'API elle-même : vous les déposez et les récupérez par des adresses signées de courte durée. Un travail tient en quatre appels : ouvrir, déposer, lancer, récupérer le résultat.

Adresse de base

https://toolty.io/api/v1/public

Envoyez votre clé dans l'en-tête Authorization. Créez vos clés dans votre compte, section API : une clé n'est montrée qu'une fois, seule son empreinte est gardée, et vous pouvez la révoquer à tout moment.

Authorization: Bearer tk_live_…

Une erreur rend un statut HTTP et un corps JSON portant un code error.

60 appels par minute et par clé, deux travaux en cours à la fois. Les fichiers déposés et les résultats sont supprimés au plus tard une heure après le traitement.

Donnez une adresse HTTPS webhook au lancement d'un travail. À sa fin, nous y postons le travail, signé avec le secret de webhook de votre clé (affiché dans votre compte). Nous relançons après 1 min, 5 min, 30 min, 2 h, 6 h, 12 h et 24 h jusqu'à une réponse 2xx. Avec Zapier, Make ou n8n, passez par leurs modules HTTP génériques et un déclencheur « Catch hook ».

{
  "id": "1d7e…",
  "type": "job.completed",
  "createdAt": "2026-11-05T14:42:10.000Z",
  "data": {
    "job": { "id": "6f1c…", "tool": "word-to-pdf", "status": "succeeded", "result": { "size": 51022, "expiresAt": "2026-11-05T15:42:00.000Z" } }
  }
}

import crypto from "node:crypto"

// header = req.headers["toolty-signature"]  →  "t=1762351200,v1=5f2c…"
function verify(header, rawBody, secret) {
  const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")))
  const expected = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex")
  const fresh = Math.abs(Date.now() / 1000 - Number(t)) < 300
  return fresh && crypto.timingSafeEqual(Buffer.from(v1), Buffer.from(expected))
}

Tous les outils que l'API couvrira. Chaque résultat remis se facture à la seconde de traitement, du moment où un worker lance le travail à sa fin, arrondie à la seconde supérieure, au prix par seconde de l'outil. Un travail en échec n'est pas facturé. Ouvrir ou lancer un travail exige un solde qui couvre une minute de traitement de l'outil. Un outil marqué Bientôt est documenté mais pas encore appelable, et un travail ouvert avec lui est refusé par tool_not_available.