L’API WorkHive

Les 18 outils de WorkHive sont appelables en HTTP, avec les mêmes prompts et les mêmes résultats que dans l’application. Envoyez du JSON, recevez du JSON.

L’accès API est inclus dans le plan Pro. Chaque appel apparaît dans votre historique, comme s’il avait été lancé depuis l’interface.

Démarrer

Créez une clé depuis Compte → Accès API. Elle n’est affichée qu’une seule fois : copiez-la immédiatement, elle n’est pas récupérable ensuite. Si vous la perdez, révoquez-la et créez-en une autre.

Vérifiez ensuite votre câblage sans dépenser d’appel — cet endpoint ne consomme rien :

curl https://workhive.tools/api/v1/me \
  -H "Authorization: Bearer wh_live_VOTRE_CLE"

{
  "plan": "pro",
  "api_access": true,
  "usage": {
    "used": 12,
    "limit": 1000,
    "remaining": 988,
    "resets_at": "2026-09-01T00:00:00.000Z"
  }
}

Authentification

Chaque requête porte sa clé dans l’en-tête Authorization. Il n’y a pas de session : la clé suffit, et elle vaut pour toute la durée de vie qu’on lui laisse.

Authorization: Bearer wh_live_...

Une clé donne accès à tout ce que votre compte peut faire. Traitez-la comme un mot de passe : jamais dans un dépôt Git, jamais dans du code exécuté par un navigateur. Créez plutôt une clé par usage — vous pouvez en révoquer une sans casser les autres.

Appeler un outil

Un seul verbe, un seul chemin : POST /api/v1/tools/{outil}. Les champs attendus dépendent de l’outil et sont listés plus bas.

curl -X POST https://workhive.tools/api/v1/tools/analyze \
  -H "Authorization: Bearer wh_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "contract": "Article 1 — Le prestataire cède l'\''intégralité de ses droits...",
    "perspective": "le prestataire",
    "lang": "fr"
  }'

La réponse contient le résultat de l’outil, plus votre consommation à jour :

{
  "tool": "analyze",
  "result": {
    "contract_type": "Contrat de prestation",
    "safety_score": 42,
    "executive_summary": "…",
    "red_flags": [ { "clause_name": "Cession de droits", "severity": "critical", … } ],
    "overall_recommendation": "…"
  },
  "saved_to_history": true,
  "usage": { "used": 13, "limit": 1000 }
}

saved_to_history vaut false si l’enregistrement a échoué. L’appel reste un succès et le résultat est bien renvoyé — mais vous ne le retrouverez pas dans l’historique.

Envoyer un fichier

Trois outils acceptent un fichier au lieu du texte : analyze, tac et cvtailor. Encodez-le en base64 dans fileData, avec son type MIME dans fileType.

{
  "fileData": "JVBERi0xLjQKJcfs...",
  "fileType": "application/pdf",
  "fileName": "contrat-acme.pdf"
}

Formats acceptés : PDF, Word (.docx, .doc), texte brut, et les images JPEG, PNG, GIF, WebP — une photo de contrat est lue directement. Maximum 10 Mo. Un fichier illisible renvoie un invalid_request et n’est pas décompté.

Limites

1000 appels par mois, remis à zéro le 1er. Les appels en erreur ne sont pas décomptés : une panne de notre côté ou un fichier illisible n’a rien livré. Le compteur est renvoyé dans chaque réponse et dans les en-têtes X-RateLimit-*.

Une limite de rafale s’applique aussi, par compte. Si vous la dépassez, l’API répond 429 avec un en-tête Retry-After en secondes — attendez ce délai plutôt que de réessayer immédiatement.

Un appel peut prendre jusqu’à une minute : les outils génèrent parfois plusieurs milliers de mots. Prévoyez un timeout large côté client.

Erreurs

Toutes les erreurs ont la même forme. Branchez votre logique sur code, jamais sur message : le code est stable, le message peut être reformulé.

{
  "error": {
    "code": "quota_exceeded",
    "message": "Plafond mensuel atteint (1000/1000 appels). …",
    "docs": "https://workhive.tools/docs/api#quota_exceeded"
  }
}

Les 18 outils

Cette liste est générée depuis le code : elle est exacte par construction. Vous pouvez la récupérer au format JSON avec GET /api/v1/tools, ce qui évite de la coder en dur de votre côté.