Integra

Genera documentazione da uno script o un agente

Un'API REST, una CLI e una skill per agenti per Claude Code, Cursor e altri agenti chiamano le stesse azioni dell'app. Genera documentazione da un video, modifica un articolo e pubblica, dal piano Solo / Small Team in su.

Inizia gratis →
Una chiamata da fuori dall'app
POST/api/external/v2/generate
202Accettata, lavoro in coda

Un'unica API per la documentazione, otto gruppi di endpoint

Articoli, cartelle, modelli, video, generazione, impostazioni del progetto, pubblicazione ed esportazione sono documentati in un'unica specifica OpenAPI, lo stesso riferimento che un browser o un generatore di codice possono leggere. Traduzione, ripristino delle versioni e rigenerazione stanno dentro quei gruppi.

Articoli, cartelle e modelli

Crea, aggiorna, sposta ed elimina articoli e cartelle, e leggi i modelli, con un'intestazione X-API-Key che autentica ogni richiesta.
Come funziona
PUT/api/external/v2/articles/{id}X-API-Key: <your key>{ "title": "Reset your password" }

Genera, poi controlla il lavoro

Punta l'endpoint di generazione su un video e mette in coda un lavoro. Interroga il lavoro per id per conoscerne lo stato, lo stesso schema asincrono che l'app usa per un'esecuzione lunga.
Come funziona
POST/api/external/v2/generate{ "videoId": "<video id>" }202 { "jobId": "<job id>", "type": "generate_article" }GET/api/external/v2/generate/{jobId}200 { "status": "completed" }

Impostazioni del progetto e pubblicazione

Leggi e aggiorna le impostazioni del progetto, e pubblica, ripubblica o annulla la pubblicazione, attraverso la stessa pipeline di pubblicazione che usa la schermata delle impostazioni nell'app.
Come funziona
POST/api/external/v2/publishPOST/api/external/v2/publish/republishDELETE/api/external/v2/publish

Ricevi una callback firmata invece di interrogare

Aggiungi un callbackUrl a una chiamata di generazione, rigenerazione, traduzione o pubblicazione, e Hinto vi invia una richiesta quando il lavoro finisce o fallisce. Aggiungi un callbackSecret e ogni chiamata porta un'intestazione X-Hinto-Signature, un HMAC-SHA256 del corpo, così puoi verificare che arrivi da Hinto. Una consegna fallita viene ritentata fino a 5 volte.
Come funziona
POST/api/external/v2/generate{ "videoId": "<video id>", "callbackUrl": "<your url>" }POST<your url>X-Hinto-Signature: <hmac>{ "event": "generation.completed", "jobId": "<job id>" }

Quattro ambiti, verificati per ogni endpoint

Ogni richiesta v2 controlla gli ambiti della chiave prima di eseguirla. Generate avvia un lavoro, write crea, modifica o sposta i contenuti, publish pubblica o ripubblica, e read copre tutto il resto. Una chiave agisce solo sul progetto per cui è stata emessa. Oggi ogni chiave porta tutti e quattro gli ambiti, perché l'emissione di una chiave limitata non è ancora realizzata.

AmbitoCosa consentePer esempio
readLeggere articoli, cartelle, modelli, video, esportazioni e stato dei lavoriGET /articlesGET /generate/{jobId}
writeCreare, spostare, duplicare e ripristinare contenuti, e caricare videoPOST /articles/emptyPATCH /folders/{id}/move
generateAvviare generazione, rigenerazione e traduzione, e importare un video da un linkPOST /generatePOST /videos/import
publishPubblicare e ripubblicare il progettoPOST /publishPOST /publish/republish
Come funzionaApri la specifica OpenAPI

Eseguilo da un terminale, o affidalo a un agente

La CLI incapsula la stessa API, e la skill per agenti incapsula la CLI, così una persona, uno script e un agente come Claude Code o Cursor arrivano tutti agli stessi comandi. Aggiungi --json per un output che uno script può leggere, e --wait per attendere il completamento di un lavoro.

$npm install -g @hintoai/cli

Installa la CLI

$hinto articles list

Elenca ogni articolo del progetto

$npx skills add hintoai/hinto-cli

Installa la skill per agenti

La skill guida la stessa CLI, così un agente che la installa arriva agli stessi comandi che digita una persona.

Come funzionaCodice e README su GitHub

Webhook: quattro eventi, un URL, le tue intestazioni

Un progetto lancia un webhook alla pubblicazione, alla ripubblicazione, all'annullamento della pubblicazione e all'archiviazione, portando tutte le intestazioni che aggiungi per l'autenticazione. Ogni chiamata invia il nome dell'evento, l'id del progetto e della pubblicazione, una marca temporale, e il nome e lo slug URL del progetto, un avviso che è accaduto qualcosa e dove trovarlo, non il contenuto stesso.

  • project.publishQuando il progetto viene pubblicato per la prima volta
  • project.republishQuando il progetto viene ripubblicato con delle modifiche
  • project.unpublishQuando la pubblicazione del progetto viene annullata
  • project.archiveQuando il progetto viene archiviato
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"
  }
}
Inviata come POST con le tue intestazioni personalizzate. Hinto tenta fino a 3 volte, attende fino a 30 secondi per ogni tentativo, e non ritenta una risposta 4xx.Come funziona

Si collega agli strumenti che già usi

Un webhook, una casella di assistenza e un costruttore di siti possono leggere tutti dallo stesso progetto.

Un webhook per i tuoi sistemi

Punta un webhook sul tuo endpoint e reagisci a una pubblicazione, ripubblicazione, annullamento della pubblicazione o archiviazione nel momento in cui accade.

Come funziona

Fin di Intercom risponde partendo da lì

Sincronizza il contenuto di un progetto in Intercom così Fin, l'agente di assistenza di Intercom, risponde partendo da quello che Hinto ha generato.

Come funziona

Framer lo importa nel tuo sito

Un plugin per Framer importa articoli e cartelle nel CMS di Framer, per un sito costruito e ospitato su Framer.

Come funziona

Cosa automatizzano i team

Articoli del centro assistenza

Rispondi alle domande che i clienti continuano a fare, in articoli che possono cercare.

SOP e guide di processo

Trasforma un tour guidato registrato in una SOP passo dopo passo, con gli screenshot nei passaggi che ne hanno bisogno.

Contesto per i tuoi strumenti IA

Dai a un assistente i tuoi processi scritti in un unico file di testo semplice.

Altre funzionalità

Visualizza

Trasforma le tue registrazioni dello schermo in elementi visivi curati, dagli screenshot automatici alle GIF personalizzate e alle immagini ritagliate che rendono i passaggi facili da seguire.

Scopri Visualizza

Modifica e collabora

Un editor a blocchi, progetti condivisi via email e una versione numerata a ogni salvataggio, che puoi visualizzare e ripristinare. Con un piano a pagamento inviti le persone che sanno, così la base di conoscenza cresce senza che una sola persona ne sia proprietaria.

Scopri Modifica e collabora

Esporta

Esporta qualsiasi articolo, cartella o progetto in PDF, Word, HTML o Markdown, oppure come file LLMs.txt per gli strumenti che il tuo team già usa.

Scopri Esporta

Guide e casi d'uso

Guide sull'API, sulla CLI e sul collegamento di Hinto al resto dei tuoi strumenti

Caso d'uso

App mobili

Scopri di più
Documentazione

API Documentation

Scopri di più
Documentazione

API Endpoint Reference

Scopri di più
Documentazione

The Hinto CLI

Scopri di più
Documentazione

Set Up Webhooks for Project Notifications

Scopri di più

Domande sull'API, la CLI e la skill per agenti di Hinto

No. Ogni richiesta porta un'intestazione X-API-Key, per una chiave creata nelle impostazioni di un progetto.

Pronto a costruire una
Base di conoscenza migliore, più veloce?

Inizia gratis e crea il tuo primo articolo in pochi minuti

Inizia gratis