Ankk CLI/API – Entwicklerhandbuch

Schnellstart

Testen Sie die CLI-Installation, richten Sie einen API-Schlüssel ein und veröffentlichen Sie für die mit diesem Schlüssel verknüpfte Marke.

Einmal installieren oder ausführen

Das öffentliche Paket heißt @anakonn/ankk, der Befehl lautet ankk. Die CLI benötigt Bun.

bunx @anakonn/ankk --json health
bun install -g @anakonn/ankk
ankk --json health

Sicher konfigurieren

Verwenden Sie einen API-Schlüssel von Ankk. Die Befehlsausgabe maskiert den vollständigen Schlüssel. In CI können Sie Umgebungsvariablen nutzen.

ankk config setup --scope global
ANKK_API_KEY=spk_... ankk config setup --scope project --api-key-env ANKK_API_KEY --yes
ankk config show

Veröffentlichen Sie vorbereitete Inhalte

Speichern Sie den Inhalt in einer JSON-Datei und senden Sie ihn an dieselbe öffentliche Planungsschnittstelle wie API-Clients.

ankk brand get --json
ankk contents publish --file payload.json
ankk contents publish --file payload.json --scheduled-for 2026-07-01T09:00:00Z

Senden Sie JSON, anstatt Formulare neu zu erstellen

Nutzlast

Verwenden Sie --file für den Inhalt. Skripte und KI-Werkzeuge können eine JSON-Datei erstellen, ohne viele Befehlsoptionen zusammenzustellen.

{
	"connection_id": "<connection_id>",
	"idempotency_key": "launch-thread-2026-07-01",
	"sns_type": "threads",
	"text": "Launch update from Ankk",
	"scheduled_for": "2026-07-01T09:00:00Z"
}

Speichern Sie Beispieldateien mit Kundendaten nicht in Git.
Verwenden Sie Idempotenzschlüssel, um Automatisierungen sicher zu wiederholen.
Angenommen bedeutet, dass die Anfrage geprüft, gespeichert und eingeplant wurde. Prüfen Sie den endgültigen Status, um die erfolgreiche Veröffentlichung zu bestätigen.

Die öffentliche API direkt aufrufen

API

CLI-Vorgänge entsprechen der öffentlichen /v1-API. Nutzen Sie Bearer-Authentifizierung; der API-Schlüssel bestimmt die Marke für die Routen unter /v1/brand.

curl -X POST https://api.ankk.app/v1/brand/contents \
  -H "Authorization: Bearer spk_..." \
  -H "Content-Type: application/json" \
  --data @payload.json

Prüfen Sie mit GET /v1/brand die mit dem API-Schlüssel verknüpfte Marke.
Die öffentliche Schnittstelle ist unter /v1/docs und /v1/openapi.json beschrieben.
Kopieren Sie niemals vollständige API-Schlüssel in Protokolle oder Supportanfragen.

Den Status nach Annahme der Anfrage verfolgen

Status

Angenommen bedeutet, dass die Anfrage geprüft, gespeichert und eingeplant wurde. Prüfen Sie den endgültigen Status, um die erfolgreiche Veröffentlichung zu bestätigen.

ankk contents list --json
ankk contents get --content-id <content_id> --json

Statuscodes: accepted, queued, publishing, published, failed, retry.
Verwenden Sie signierte Webhooks, um Statusänderungen an andere Systeme zu senden.
Die Annahme einer Anfrage ist der erste Schritt. Verfolgen Sie jeden Beitrag bis zum endgültigen Ergebnis und prüfen Sie Fehler bei Bedarf.

Fordern Sie die KI-Tools auf, Ankk zu verwenden und nicht zu ersetzen

Erstellen Sie Inhalte selbst oder mit externen KI-Werkzeugen, planen Sie Beiträge für unterstützte Kanäle und verfolgen Sie die Ergebnisse in Ankk.

Codex

Erstelle aus diesen Versionshinweisen die Daten für einen Threads-Beitrag, speichere sie in tmp/launch-thread.json und führe ankk contents publish mit meiner konfigurierten Marke aus.

Claude Code

Prüfe, ob payload.json die Felder connection_id, idempotency_key, sns_type, text und scheduled_for enthält. Zeige dann den genauen Befehl ankk contents publish.

ChatGPT

Entwirf drei für die Kanäle geeignete Textvarianten und gib eine JSON-Datei zurück, die ich an ankk contents publish --file payload.json übergeben kann.

Sicherheitsgrenzen

Setzen Sie spk_ API-Schlüssel nicht vollständig Modellen, Protokollen, Screenshots oder Ausgabekommentaren aus.
Teilen Sie den Benutzern nicht mit, dass ein erfolgreicher Befehl bedeutet, dass die Veröffentlichung durch den Anbieter bereits erfolgreich war.
Dokumentieren Sie versteckte oder ruhende CLI-Befehle nicht als öffentliche Funktionen.
Verwenden Sie API-Schlüssel, webhooks und Statusprüfungen zur Automatisierung anstelle des direkten Datenbankzugriffs.

Ankk über CLI, APIund KI-Werkzeuge nutzen