Intégrer

Générez de la documentation depuis un script ou un agent

Une API REST, un CLI et une compétence d'agent pour Claude Code, Cursor et d'autres agents appellent les mêmes actions que l'application. Générez de la documentation à partir d'une vidéo, modifiez un article et publiez, avec le plan Solo / Petite équipe et au-delà.

Un appel depuis l'extérieur de l'application
POST/api/external/v2/generate
202Accepté, travail mis en file

Une seule API de documentation, huit groupes de points de terminaison

Articles, dossiers, modèles, vidéos, génération, paramètres de projet, publication et export sont documentés dans une seule spécification OpenAPI, la même référence qu'un navigateur ou un générateur de code peut lire. Traduction, restauration de version et régénération se trouvent dans ces groupes.

Articles, dossiers et modèles

Créez, mettez à jour, déplacez et supprimez articles et dossiers, et lisez les modèles, avec un en-tête X-API-Key qui authentifie chaque requête.
Comment ça fonctionne
PUT/api/external/v2/articles/{id}X-API-Key: <your key>{ "title": "Reset your password" }

Générez, puis suivez le travail

Pointez le point de terminaison generate vers une vidéo et il met un travail en file. Interrogez le travail par son id pour connaître son statut, le même schéma asynchrone que l'application elle-même utilise pour une exécution longue.
Comment ça fonctionne
POST/api/external/v2/generate{ "videoId": "<video id>" }202 { "jobId": "<job id>", "type": "generate_article" }GET/api/external/v2/generate/{jobId}200 { "status": "completed" }

Paramètres de projet et publication

Lisez et mettez à jour les paramètres du projet, et publiez, republiez ou dépubliez, via le même pipeline de publication que l'écran de paramètres de l'application.
Comment ça fonctionne
POST/api/external/v2/publishPOST/api/external/v2/publish/republishDELETE/api/external/v2/publish

Recevez un rappel signé au lieu d'interroger

Ajoutez un callbackUrl à un appel generate, regenerate, translate ou publish, et Hinto y envoie une requête quand le travail se termine ou échoue. Ajoutez un callbackSecret et chaque appel porte un en-tête X-Hinto-Signature, un HMAC-SHA256 du corps, pour que vous puissiez vérifier qu'il vient de Hinto. Une livraison échouée est tentée jusqu'à 5 fois.
Comment ça fonctionne
POST/api/external/v2/generate{ "videoId": "<video id>", "callbackUrl": "<your url>" }POST<your url>X-Hinto-Signature: <hmac>{ "event": "generation.completed", "jobId": "<job id>" }

Quatre portées, appliquées par point de terminaison

Chaque requête v2 vérifie les portées de la clé avant de s'exécuter. generate démarre un travail, write crée, modifie ou déplace du contenu, publish publie ou republie, et read couvre tout le reste. Une clé n'agit que sur le projet pour lequel elle a été émise. Chaque clé porte aujourd'hui les quatre portées, car l'émission d'une clé restreinte n'est pas encore construite.

PortéeCe qu'elle autorisePar exemple
readLire les articles, dossiers, modèles, vidéos, exports et le statut des travauxGET /articlesGET /generate/{jobId}
writeCréer, déplacer, dupliquer et restaurer du contenu, et importer des vidéosPOST /articles/emptyPATCH /folders/{id}/move
generateDémarrer la génération, la régénération et la traduction, et importer une vidéo depuis un lienPOST /generatePOST /videos/import
publishPublier et republier le projetPOST /publishPOST /publish/republish

Lancez-le depuis un terminal, ou confiez-le à un agent

Le CLI encapsule la même API, et la compétence d'agent encapsule le CLI, une personne, un script et un agent comme Claude Code ou Cursor atteignent donc les mêmes commandes. Ajoutez --json pour une sortie qu'un script peut lire, et --wait pour bloquer jusqu'à la fin d'un travail.

$npm install -g @hintoai/cli

Installer le CLI

$hinto articles list

Lister chaque article du projet

$npx skills add hintoai/hinto-cli

Installer la compétence d'agent

Webhooks : quatre événements, une URL, vos propres en-têtes

Un projet déclenche un webhook à la publication, la republication, la dépublication et l'archivage, en portant les en-têtes que vous ajoutez pour l'authentification. Chaque appel envoie un nom d'événement, l'id du projet et de la publication, un horodatage, et le nom et le slug d'URL du projet, un avis indiquant que quelque chose s'est produit et où le trouver, pas le contenu lui-même.

  • project.publishQuand le projet est publié pour la première fois
  • project.republishQuand le projet est republié avec des changements
  • project.unpublishQuand le projet est dépublié
  • project.archiveQuand le projet est archivé
POSThttps://api.example.com/webhooksContent-Type: application/json
{
  "event": "project.republish",
  "projectId": "<project id>",
  "publicationId": "<publication id>",
  "timestamp": "2026-09-15T10:24:00.000Z",
  "data": {
    "projectName": "Acme Help Center",
    "urlSlug": "acme"
  }
}
Envoyé en POST avec vos en-têtes personnalisés ajoutés. Hinto tente jusqu'à 3 fois, attend jusqu'à 30 secondes par tentative, et ne réessaie pas après une réponse 4xx.Comment ça fonctionne

Se connecte aux outils que vous utilisez déjà

Un webhook, une boîte de réception de support et un constructeur de site peuvent tous lire dans le même projet.

Un webhook pour vos propres systèmes

Pointez un webhook vers votre propre point de terminaison et réagissez à une publication, une republication, une dépublication ou un archivage au moment où cela se produit.

Fin d'Intercom y puise ses réponses

Synchronisez le contenu d'un projet dans Intercom pour que Fin, l'agent de support d'Intercom, réponde à partir de ce que Hinto a généré.

Framer l'importe dans votre site

Un plugin Framer importe articles et dossiers dans le CMS de Framer, pour un site construit et hébergé dans Framer.

Questions sur l'API Hinto, le CLI et la compétence d'agent

Non. Chaque requête porte un en-tête X-API-Key, pour une clé créée dans les paramètres d'un projet.

Prêt à construire une meilleure
base de connaissances, plus vite ?

Commencez gratuitement et créez votre premier article en quelques minutes