Entwickler

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

Installieren Sie zuerst Bun-First CLI, konfigurieren Sie einen öffentlichen API key und senden Sie vorbereitete Inhalte von Codex, Claude Code, ChatGPT, Skripten oder Automatisierungstools an die Ankk-Planung.

terminal
$ bunx @anakonn/ankk --json health
$ ankk config setup --scope project
$ ankk contents publish --brand-ref acme --file payload.json

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 --brand-ref <brand_ref> --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 brands list --json
ankk contents publish --brand-ref <brand_ref> --file payload.json
ankk contents publish --brand-ref <brand_ref> --file payload.json --scheduled-for 2026-07-01T09:00:00Z
Nutzlast

Senden Sie JSON, anstatt Formulare neu zu erstellen

Verwenden Sie --file für Inhaltskörper, damit Skripte und AI-Tools strukturierte Payloads ohne einen fragilen Stapel von Flags erzeugen können.

  • 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.
{
"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"
}
API

Rufen Sie den öffentlichen API direkt auf

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

  • Verwenden Sie GET /v1/brands, 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.
curl -X POST https://api-public.ankk.app/v1/brands/<brand_ref>/contents \
-H "Authorization: Bearer spk_..." \
-H "Content-Type: application/json" \
--data @payload.json
Status

Verfolgen Sie die Arbeit nach der Abnahme

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.

  • 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.
ankk contents list --brand-ref <brand_ref> --json
ankk contents get --brand-ref <brand_ref> --content-id <content_id> --json

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.

Sind Sie bereit, Ankk in Ihren Workflow einzubinden?

Beginnen Sie mit CLI und verschieben Sie dann dieselben Nutzlasten in Skripte, CI-Jobs oder AI-Toolausführungen.