Integrar

Genera documentación desde un script o un agente

Una API REST, un CLI y una habilidad para agentes en Claude Code, Cursor y otros agentes llaman a las mismas acciones que la aplicación. Genera documentación a partir de un video, edita un artículo y publica, en el plan Solo / Small Team y superiores.

Una llamada desde fuera de la aplicación
POST/api/external/v2/generate
202Aceptado, trabajo en cola

Una API de documentación, ocho grupos de endpoints

Los artículos, las carpetas, las plantillas, los videos, la generación, los ajustes del proyecto, la publicación y la exportación están documentados en una sola especificación OpenAPI, la misma referencia que puede leer un navegador o un generador de código. La traducción, la restauración de versiones y la regeneración van dentro de esos grupos.

Artículos, carpetas y plantillas

Crea, actualiza, mueve y elimina artículos y carpetas, y lee plantillas, con una cabecera X-API-Key que autentica cada petición.
Cómo funciona
PUT/api/external/v2/articles/{id}X-API-Key: <your key>{ "title": "Reset your password" }

Genera y luego consulta el trabajo

Apunta el endpoint de generación a un video y pone un trabajo en cola. Consulta el trabajo por su id para ver su estado, el mismo patrón asíncrono que la propia aplicación usa para una ejecución larga.
Cómo funciona
POST/api/external/v2/generate{ "videoId": "<video id>" }202 { "jobId": "<job id>", "type": "generate_article" }GET/api/external/v2/generate/{jobId}200 { "status": "completed" }

Ajustes del proyecto y publicación

Lee y actualiza los ajustes del proyecto, y publica, vuelve a publicar o despublica, a través de la misma canalización de publicación que usa la pantalla de ajustes de la aplicación.
Cómo funciona
POST/api/external/v2/publishPOST/api/external/v2/publish/republishDELETE/api/external/v2/publish

Recibe una llamada firmada en lugar de consultar

Añade un callbackUrl a una llamada de generación, regeneración, traducción o publicación, y Hinto le envía una petición cuando el trabajo termina o falla. Añade un callbackSecret y cada llamada lleva una cabecera X-Hinto-Signature, un HMAC-SHA256 del cuerpo, para que puedas comprobar que viene de Hinto. Una entrega fallida se reintenta hasta 5 veces.
Cómo funciona
POST/api/external/v2/generate{ "videoId": "<video id>", "callbackUrl": "<your url>" }POST<your url>X-Hinto-Signature: <hmac>{ "event": "generation.completed", "jobId": "<job id>" }

Cuatro alcances, aplicados por endpoint

Cada petición v2 comprueba los alcances de la clave antes de ejecutarse. Generate inicia un trabajo, write crea, edita o mueve contenido, publish publica o vuelve a publicar, y read cubre todo lo demás. Una clave actúa solo en el proyecto para el que se emitió. Hoy todas las claves llevan los cuatro alcances, porque emitir una clave restringida todavía no está construido.

AlcanceQué permitePor ejemplo
readLeer artículos, carpetas, plantillas, videos, exportaciones y el estado de los trabajosGET /articlesGET /generate/{jobId}
writeCrear, mover, duplicar y restaurar contenido, y subir videosPOST /articles/emptyPATCH /folders/{id}/move
generateIniciar generaciones, regeneraciones y traducciones, e importar un video desde un enlacePOST /generatePOST /videos/import
publishPublicar y volver a publicar el proyectoPOST /publishPOST /publish/republish

Ejecútalo desde un terminal, o pásalo a un agente

El CLI envuelve la misma API, y la habilidad para agentes envuelve el CLI, así que una persona, un script y un agente como Claude Code o Cursor llegan a los mismos comandos. Añade --json para una salida que un script puede leer, y --wait para bloquear hasta que un trabajo termine.

$npm install -g @hintoai/cli

Instala el CLI

$hinto articles list

Enumera todos los artículos del proyecto

$npx skills add hintoai/hinto-cli

Instala la habilidad para agentes

Webhooks: cuatro eventos, una URL, tus propias cabeceras

Un proyecto dispara un webhook al publicar, volver a publicar, despublicar y archivar, y lleva las cabeceras que añadas para autenticar. Cada llamada envía un nombre de evento, el id del proyecto y de la publicación, una marca de tiempo, y el nombre y el slug de URL del proyecto, un aviso de que algo ocurrió y dónde encontrarlo, no el contenido en sí.

  • project.publishCuando el proyecto se publica por primera vez
  • project.republishCuando el proyecto se vuelve a publicar con cambios
  • project.unpublishCuando el proyecto se despublica
  • project.archiveCuando el proyecto se archiva
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"
  }
}
Se envía como POST con tus cabeceras personalizadas añadidas. Hinto lo intenta hasta 3 veces, espera hasta 30 segundos en cada intento y no reintenta una respuesta 4xx.Cómo funciona

Se conecta con las herramientas que ya usas

Un webhook, una bandeja de soporte y un creador de sitios web pueden leer todos del mismo proyecto.

Un webhook para tus propios sistemas

Apunta un webhook a tu propio endpoint y reacciona a una publicación, una republicación, una despublicación o un archivado en el momento en que ocurre.

Fin de Intercom responde a partir de él

Sincroniza el contenido de un proyecto con Intercom para que Fin, el agente de soporte de Intercom, responda a partir de lo que generó Hinto.

Framer lo importa a tu sitio

Un plugin de Framer importa artículos y carpetas al CMS de Framer, para un sitio construido y alojado en Framer.

Preguntas sobre la API, el CLI y la habilidad para agentes de Hinto

No. Cada petición lleva una cabecera X-API-Key, para una clave creada en los ajustes de un proyecto.

¿Listo para crear una
Base de conocimiento mejor y más rápida?

Empieza gratis y crea tu primer artículo en minutos