Ankk CLI/API Entwicklerhandbuch

Schnellstart

Ein kleiner Pfad, der das Paket, API key und den markenbezogenen Veröffentlichungsworkflow beweist.

Einmal installieren oder ausführen

Das öffentliche Paket ist @anakonn/ankk und die Binärdatei ist ankk. Der CLI erfordert derzeit Bun.

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

Sicher konfigurieren

Verwenden Sie einen API key von Ankk. Die Befehlsausgabe schwärzt den vollständigen Schlüssel und Umgebungsvariablen funktionieren für CI.

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

Erstellen Sie eine JSON-Nutzlast und übergeben Sie sie an denselben öffentlichen Planungsvertrag, der von API-Clients verwendet wird.

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 Inhaltskörper, damit Skripte und AI-Tools strukturierte Payloads ohne einen fragilen Stapel von Flags erzeugen können.

{
  "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"
}

Halten Sie Payload-Geräte außerhalb von Git, wenn sie Kundendaten enthalten.
Verwenden Sie Idempotenzschlüssel für wiederholbare Automatisierung.
Behandlung wie geplant akzeptiert, jedoch vom Anbieter nicht erfolgreich.

Rufen Sie den öffentlichen API direkt auf

API

Jeder CLI-Workflow wird wieder dem öffentlichen /v1 API zugeordnet. Verwenden Sie Bearer-Authentifizierung und markenbezogene Routen für Automatisierungs-Clients.

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

Verwenden Sie GET /v1/brand, um zugängliche Marken zu entdecken.
Verwenden Sie /v1/docs und /v1/openapi.json für den öffentlichen Auftrag.
Fügen Sie niemals den vollständigen API keys in Protokolle oder Tickets ein.

Verfolgen Sie die Arbeit nach der Abnahme

Status

Die Veröffentlichung erfolgt asynchron. Der API akzeptiert validierte Arbeit, behält sie bei und plant die Ausführung; Die Fertigstellung durch den Anbieter erfolgt später.

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

Zu den erwarteten Status gehören „Akzeptiert“, „In der Warteschlange“, „Veröffentlicht“, „Veröffentlicht“, „Fehlgeschlagen“ und „Wiederholen“.
Verwenden Sie das signierte webhooks, wenn ein anderes System Statusaktualisierungen benötigt.
Der Betriebsstatus bleibt in Ankk und nicht in der Eingabeaufforderung AI.

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

Lassen Sie das Tool AI Kopien, Nutzlasten oder Befehle vorbereiten. Ankk bleibt das Planungs- und Statussystem.

Codex

Erstellen Sie aus diesem Versionshinweis eine Threads-Startnutzlast, speichern Sie sie als tmp/launch-thread.json und führen Sie dann ankk contents publish mit meiner konfigurierten Marke aus.

Claude Code

Überprüfen Sie payload.json auf fehlende Verbindungs-ID, Idempotenzschlüssel, SNS-Typ, Text und geplantes_for. Zeigen Sie dann den genauen ankk contents publish-Befehl an.

ChatGPT

Entwerfen Sie drei kanalsichere Beitragsvarianten und geben Sie eine JSON-Nutzlast zurück, die ich an ankk contents publish —file payload.json übergeben kann.

Sicherheitsgrenzen

Setzen Sie spk_ API keys 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 keys, webhooks und Statusprüfungen zur Automatisierung anstelle des direkten Datenbankzugriffs.

Verwenden Sie Ankk von CLI, API, und AI-Tools