Guide du développeur Ankk CLI/API

Démarrage rapide

Un petit chemin qui prouve le package, API key et le workflow de publication à l’échelle de la marque.

Installer ou exécuter une fois

Le package public est @anakonn/ankk et le binaire est ankk. Le CLI nécessite actuellement Bun.

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

Configurez en toute sécurité

Utilisez un API key de Ankk. La sortie de la commande supprime la clé complète et les variables d’environnement fonctionnent pour 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

Publier le contenu préparé

Créez une charge utile JSON et transmettez-la au même contrat de planification public utilisé par les clients API.

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

Envoyer du JSON au lieu de reconstruire les formulaires

Charge utile

Utilisez —file pour les corps de contenu afin que les scripts et les outils AI puissent produire des charges utiles structurées sans une pile fragile d’indicateurs.

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

Conservez les éléments de charge utile en dehors de git lorsqu’ils contiennent des données client.
Utilisez des clés d’idempotence pour une automatisation reproductible.
Traitement accepté comme prévu, mais non réussi par le fournisseur.

Appelez directement le public API

API

Chaque flux de travail CLI renvoie au public /v1 API. Utilisez l’authentification Bearer et les routes à portée de marque pour les clients d’automatisation.

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

Utilisez GET /v1/brand pour découvrir des marques accessibles.
Utilisez /v1/docs et /v1/openapi.json pour le contrat public.
Ne collez jamais API keys complet dans des journaux ou des tickets.

Suivre les travaux après acceptation

Statut

La publication est asynchrone. Le API accepte le travail validé, le conserve et planifie son exécution ; l’achèvement du fournisseur se produit plus tard.

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

Les états attendus incluent accepté, mis en file d’attente, publication, publié, échoué et nouvelle tentative.
Utilisez webhooks signé lorsqu’un autre système a besoin de mises à jour d’état.
L’état opérationnel reste dans Ankk au lieu de l’invite AI.

Invite les outils AI à utiliser Ankk, et non à le remplacer

Laissez l’outil AI préparer la copie, les charges utiles ou les commandes. Ankk reste le système de planification et de statut.

Codex

Créez une charge utile de lancement Threads à partir de cette note de version, enregistrez-la sous tmp/launch-thread.json, puis exécutez ankk contents publish avec ma marque configurée.

Claude Code

Inspectez payload.json pour détecter les éléments connection_id, idempotency_key, sns_type, text et selected_for manquants. Affichez ensuite la commande exacte ankk contents publish.

ChatGPT

Rédigez trois variantes de publication sécurisées pour les canaux et renvoyez une charge utile JSON que je peux transmettre à ankk contents publish —file payload.json.

Limites de sécurité

Ne pas exposer l’intégralité du spk_ API keys aux modèles, journaux, captures d’écran ou émettre des commentaires.
Ne dites pas aux utilisateurs que le succès de la commande signifie que la publication du fournisseur a déjà réussi.
Ne documentez pas les commandes CLI masquées ou dormantes en tant que fonctionnalités publiques.
Utilisez API keys, webhooks et les vérifications d’état pour l’automatisation au lieu de l’accès direct à la base de données.

Utilisez Ankk de CLI, API, et outils AI