Integrieren

Erzeugen Sie Dokumentation aus einem Skript oder einem Agenten

Eine REST API, eine CLI und ein Agent-Skill für Claude Code, Cursor und andere Agenten rufen dieselben Aktionen auf wie die App. Erzeugen Sie Dokumentation aus einem Video, bearbeiten Sie einen Artikel und veröffentlichen Sie, im Plan Solo / Small Team und darüber.

Ein Aufruf von außerhalb der App
POST/api/external/v2/generate
202Angenommen, Auftrag eingereiht

Eine Dokumentations-API, acht Endpunktgruppen

Artikel, Ordner, Vorlagen, Videos, Generierung, Projekteinstellungen, Veröffentlichung und Export sind in einer einzigen OpenAPI-Spezifikation dokumentiert, derselben Referenz, die ein Browser oder ein Codegenerator lesen kann. Übersetzung, Wiederherstellung von Versionen und Neugenerierung stecken in diesen Gruppen.

Artikel, Ordner und Vorlagen

Erstellen, aktualisieren, verschieben und löschen Sie Artikel und Ordner, und lesen Sie Vorlagen, wobei ein X-API-Key-Header jede Anfrage authentifiziert.
So funktioniert es
PUT/api/external/v2/articles/{id}X-API-Key: <your key>{ "title": "Reset your password" }

Generieren, dann den Auftrag prüfen

Richten Sie den Generate-Endpunkt auf ein Video und er reiht einen Auftrag ein. Fragen Sie den Auftrag per ID nach seinem Status ab, dasselbe asynchrone Muster, das die App selbst für einen länger laufenden Durchlauf nutzt.
So funktioniert es
POST/api/external/v2/generate{ "videoId": "<video id>" }202 { "jobId": "<job id>", "type": "generate_article" }GET/api/external/v2/generate/{jobId}200 { "status": "completed" }

Projekteinstellungen und Veröffentlichung

Lesen und aktualisieren Sie Projekteinstellungen, und veröffentlichen, erneut veröffentlichen oder ziehen Sie zurück, über dieselbe Veröffentlichungs-Pipeline, die der Einstellungsbildschirm in der App nutzt.
So funktioniert es
POST/api/external/v2/publishPOST/api/external/v2/publish/republishDELETE/api/external/v2/publish

Einen signierten Callback statt Abfragen erhalten

Fügen Sie einem Aufruf von generate, regenerate, translate oder publish eine callbackUrl hinzu, und Hinto sendet dorthin, wenn der Auftrag fertig ist oder fehlschlägt. Fügen Sie ein callbackSecret hinzu und jeder Aufruf trägt einen X-Hinto-Signature-Header, einen HMAC-SHA256 des Bodys, sodass Sie prüfen können, dass er von Hinto kam. Eine fehlgeschlagene Zustellung wird bis zu 5 Mal versucht.
So funktioniert es
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 Berechtigungen, pro Endpunkt durchgesetzt

Jede v2-Anfrage prüft die Berechtigungen des Schlüssels, bevor sie läuft. generate startet einen Auftrag, write erstellt, bearbeitet oder verschiebt Inhalte, publish veröffentlicht oder veröffentlicht erneut, und read deckt alles andere ab. Ein Schlüssel wirkt nur auf das Projekt, für das er ausgestellt wurde. Jeder Schlüssel trägt heute alle vier Berechtigungen, da das Ausstellen eines eingeschränkten Schlüssels noch nicht gebaut ist.

BerechtigungWas sie erlaubtZum Beispiel
readArtikel, Ordner, Vorlagen, Videos, Exporte und Auftragsstatus lesenGET /articlesGET /generate/{jobId}
writeInhalte erstellen, verschieben, duplizieren und wiederherstellen, und Videos hochladenPOST /articles/emptyPATCH /folders/{id}/move
generateGenerierung, Neugenerierung und Übersetzung starten, und ein Video über einen Link importierenPOST /generatePOST /videos/import
publishDas Projekt veröffentlichen und erneut veröffentlichenPOST /publishPOST /publish/republish

Aus einem Terminal ausführen, oder einem Agenten übergeben

Die CLI umschließt dieselbe API, und der Agent-Skill umschließt die CLI, sodass eine Person, ein Skript und ein Agent wie Claude Code oder Cursor alle dieselben Befehle erreichen. Fügen Sie --json hinzu für Ausgaben, die ein Skript lesen kann, und --wait, um zu warten, bis ein Auftrag fertig ist.

$npm install -g @hintoai/cli

Die CLI installieren

$hinto articles list

Jeden Artikel im Projekt auflisten

$npx skills add hintoai/hinto-cli

Den Agent-Skill installieren

Webhooks: vier Events, eine URL, Ihre eigenen Header

Ein Projekt löst einen Webhook aus beim Veröffentlichen, erneuten Veröffentlichen, Zurückziehen und Archivieren, und trägt alle Header mit, die Sie zur Authentifizierung hinzufügen. Jeder Aufruf sendet einen Eventnamen, die Projekt- und Publikations-ID, einen Zeitstempel und den Namen und URL-Slug des Projekts, einen Hinweis, dass etwas passiert ist und wo es zu finden ist, nicht den Inhalt selbst.

  • project.publishWenn das Projekt zum ersten Mal veröffentlicht wird
  • project.republishWenn das Projekt mit Änderungen erneut veröffentlicht wird
  • project.unpublishWenn das Projekt zurückgezogen wird
  • project.archiveWenn das Projekt archiviert wird
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"
  }
}
Wird als POST mit Ihren eigenen Headern gesendet. Hinto versucht es bis zu 3 Mal, wartet je Versuch bis zu 30 Sekunden und wiederholt eine 4xx-Antwort nicht.So funktioniert es

Verbindet sich mit den Tools, die Sie schon betreiben

Ein Webhook, ein Support-Postfach und ein Website-Baukasten können alle aus demselben Projekt lesen.

Ein Webhook für Ihre eigenen Systeme

Richten Sie einen Webhook auf Ihren eigenen Endpunkt und reagieren Sie auf ein Veröffentlichen, erneutes Veröffentlichen, Zurückziehen oder Archivieren, während es passiert.

Intercom Fin antwortet daraus

Synchronisieren Sie die Inhalte eines Projekts nach Intercom, damit Fin, der Support-Agent von Intercom, aus dem antwortet, was Hinto erzeugt hat.

Framer importiert es in Ihre Website

Ein Framer-Plugin importiert Artikel und Ordner in das Framer-CMS, für eine Website, die in Framer gebaut und gehostet wird.

Fragen zur Hinto API, zur CLI und zum Agent-Skill

Nein. Jede Anfrage trägt einen X-API-Key-Header, für einen Schlüssel, der in den Einstellungen eines Projekts erstellt wurde.

Bereit für eine bessere
Wissensdatenbank, schneller?

Kostenlos starten & Ihren ersten Artikel in Minuten erstellen