Integreren

Genereer documentatie vanuit een script of een agent

Een REST API, een CLI en een agent skill voor Claude Code, Cursor en andere agents roepen dezelfde acties aan als de app. Genereer documentatie uit een video, bewerk een artikel en publiceer, op het Solo / Small Team-plan en hoger.

Een aanroep van buiten de app
POST/api/external/v2/generate
202Geaccepteerd, job in de wachtrij

Eén documentatie-API, acht endpointgroepen

Artikelen, mappen, sjablonen, video's, generatie, projectinstellingen, publiceren en exporteren staan gedocumenteerd in één OpenAPI-spec, dezelfde referentie die een browser of een codegenerator kan lezen. Vertalen, een versie terugzetten en opnieuw genereren zitten binnen die groepen.

Artikelen, mappen en sjablonen

Maak, werk bij, verplaats en verwijder artikelen en mappen, en lees sjablonen, met een X-API-Key-header die elk verzoek authenticeert.
Hoe dit werkt
PUT/api/external/v2/articles/{id}X-API-Key: <your key>{ "title": "Reset your password" }

Genereer en kijk daarna hoe de job ervoor staat

Richt het generate-endpoint op een video en het zet een job in de wachtrij. Poll de job op id voor de status, hetzelfde asynchrone patroon dat de app zelf gebruikt voor een langlopende ronde.
Hoe dit werkt
POST/api/external/v2/generate{ "videoId": "<video id>" }202 { "jobId": "<job id>", "type": "generate_article" }GET/api/external/v2/generate/{jobId}200 { "status": "completed" }

Projectinstellingen en publiceren

Lees en werk projectinstellingen bij, en publiceer, publiceer opnieuw of depubliceer, via dezelfde publicatiepijplijn die het instellingenscherm in de app gebruikt.
Hoe dit werkt
POST/api/external/v2/publishPOST/api/external/v2/publish/republishDELETE/api/external/v2/publish

Krijg een ondertekende callback in plaats van te pollen

Voeg een callbackUrl toe aan een generate-, regenerate-, translate- of publish-aanroep, en Hinto post ernaar zodra de job klaar is of mislukt. Voeg een callbackSecret toe en elke aanroep draagt een X-Hinto-Signature-header, een HMAC-SHA256 van de body, zodat je kunt controleren dat hij van Hinto komt. Een mislukte bezorging wordt tot 5 keer opnieuw geprobeerd.
Hoe dit werkt
POST/api/external/v2/generate{ "videoId": "<video id>", "callbackUrl": "<your url>" }POST<your url>X-Hinto-Signature: <hmac>{ "event": "generation.completed", "jobId": "<job id>" }

Vier scopes, per endpoint afgedwongen

Elk v2-verzoek controleert de scopes van de key voordat het loopt. Generate start een job, write maakt, wijzigt of verplaatst content, publish publiceert of publiceert opnieuw, en read dekt al het andere. Een key werkt alleen op het project waarvoor hij is uitgegeven. Elke key draagt vandaag alle vier de scopes, omdat een beperkte key uitgeven nog niet is gebouwd.

ScopeWat het toestaatBijvoorbeeld
readArtikelen, mappen, sjablonen, video's, exports en jobstatus lezenGET /articlesGET /generate/{jobId}
writeContent maken, verplaatsen, dupliceren en terugzetten, en video's uploadenPOST /articles/emptyPATCH /folders/{id}/move
generateGeneratie, hergeneratie en vertaling starten, en een video importeren vanuit een linkPOST /generatePOST /videos/import
publishHet project publiceren en opnieuw publicerenPOST /publishPOST /publish/republish

Voer het uit vanuit een terminal, of geef het aan een agent

De CLI zit om dezelfde API heen, en de agent skill zit om de CLI heen, dus een persoon, een script en een agent zoals Claude Code of Cursor komen allemaal bij dezelfde commando's uit. Voeg --json toe voor output die een script kan lezen, en --wait om te wachten tot een job klaar is.

$npm install -g @hintoai/cli

Installeer de CLI

$hinto articles list

Somt elk artikel in het project op

$npx skills add hintoai/hinto-cli

Installeer de agent skill

Webhooks: vier events, één URL, je eigen headers

Een project vuurt een webhook bij publiceren, opnieuw publiceren, depubliceren en archiveren, met alle headers die je voor authenticatie toevoegt. Elke aanroep stuurt een eventnaam, de project- en publicatie-id, een tijdstempel, en de naam en URL-slug van het project, een melding dat er iets is gebeurd en waar je het vindt, niet de content zelf.

  • project.publishWanneer het project voor het eerst wordt gepubliceerd
  • project.republishWanneer het project opnieuw wordt gepubliceerd met wijzigingen
  • project.unpublishWanneer het project wordt gedepubliceerd
  • project.archiveWanneer het project wordt gearchiveerd
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"
  }
}
Verstuurd als POST met jouw eigen headers erbij. Hinto probeert het tot 3 keer, wacht per poging tot 30 seconden, en probeert een 4xx-antwoord niet opnieuw.Hoe dit werkt

Sluit aan op de tools die je al gebruikt

Een webhook, een supportinbox en een websitebouwer kunnen allemaal uit hetzelfde project lezen.

Een webhook voor je eigen systemen

Richt een webhook op je eigen endpoint en reageer op een publicatie, herpublicatie, depublicatie of archivering op het moment dat die gebeurt.

Intercom Fin antwoordt eruit

Synchroniseer de content van een project naar Intercom, zodat Fin, de supportagent van Intercom, antwoordt uit wat Hinto heeft gegenereerd.

Framer importeert het in je site

Een Framer-plug-in importeert artikelen en mappen in de Framer CMS, voor een site die in Framer is gebouwd en gehost.

Vragen over de Hinto API, de CLI en de agent skill

Nee. Elk verzoek draagt een X-API-Key-header, voor een key die in de instellingen van één project is aangemaakt.

Klaar om een betere
kennisbasis te bouwen, sneller?

Start gratis en maak je eerste artikel in enkele minuten