Utilisez Ankk depuis le CLI, l’APIet vos outils d’IA

Démarrage rapide

Testez l’installation du CLI, la configuration de la clé API et la publication pour la marque liée à cette clé.

Installer ou exécuter une fois

Le package public est @anakonn/ankk et la commande est ankk. Le CLI nécessite Bun.

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

Configurez en toute sécurité

Utilisez une clé API d’Ankk. La sortie des commandes masque la clé complète. Les variables d’environnement permettent de la configurer dans la 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é

Enregistrez le contenu dans un fichier JSON et envoyez-le à la même interface publique de programmation que les clients de l’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 envoyer le contenu. Les scripts et outils d’IA peuvent préparer un fichier JSON sans assembler de nombreux paramètres.

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

• Ne conservez pas dans Git les fichiers d’exemple contenant des données client.
• Utilisez des clés d’idempotence pour répéter les automatisations en toute sécurité.
• Reçu signifie que la demande a été validée, enregistrée et programmée. Vérifiez le statut final pour confirmer la réussite de la publication.

Appelez directement l’API publique

API

Les opérations du CLI correspondent à l’API publique /v1. Utilisez l’authentification Bearer ; la clé API détermine la marque des routes /v1/brand.

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

• Utilisez GET /v1/brand pour consulter la marque liée à la clé API.
• Consultez /v1/docs et /v1/openapi.json pour la spécification de l’interface publique.
• Ne collez jamais de clés API complètes dans les journaux ou les demandes d’assistance.

Suivez le statut après réception de la demande

Statut

Reçu signifie que la demande a été validée, enregistrée et programmée. Vérifiez le statut final pour confirmer la réussite de la publication.

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

• Codes de statut: accepted, queued, publishing, published, failed, retry.
• Utilisez des webhooks signés pour transmettre les changements de statut à d’autres systèmes.
• La réception d’une demande est la première étape. Suivez chaque publication jusqu’au résultat final et examinez les échecs si nécessaire.

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

Préparez vos contenus vous-même ou avec des outils d’IA externes, programmez-les sur les canaux pris en charge et suivez les résultats dans Ankk.

Codex

Crée les données d’une publication de lancement pour Threads à partir de ces notes, enregistre-les dans tmp/launch-thread.json, puis exécute ankk contents publish avec ma marque configurée.

Claude Code

Vérifie que payload.json contient connection_id, idempotency_key, sns_type, text et scheduled_for. Affiche ensuite la commande exacte ankk contents publish.

ChatGPT

Rédige trois variantes adaptées aux canaux et renvoie un fichier JSON que je peux transmettre à ankk contents publish --file payload.json.

Limites de sécurité

• Ne pas exposer l'intégralité du spk_ clés API 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 clés API, webhooks et les vérifications d'état pour l'automatisation au lieu de l'accès direct à la base de données.