Ankk CLI/API Guía para desarrolladores

Inicio rápido

Una pequeña ruta que demuestra el paquete, API key y el flujo de trabajo de publicación con alcance de marca.

Instalar o ejecutar una vez

El paquete público es @anakonn/ankk y el binario es ankk. El CLI actualmente requiere Bun.

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

Configurar de forma segura

Utilice un API key de Ankk. La salida del comando redacta la clave completa y las variables de entorno funcionan para 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

Publicar contenido preparado

Cree una carga útil JSON y entréguela al mismo contrato de programación pública utilizado por los clientes API.

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

Enviar JSON en lugar de reconstruir formularios

Carga útil

Utilice —file para los cuerpos de contenido para que los scripts y las herramientas AI puedan producir cargas útiles estructuradas sin una frágil pila de indicadores.

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

Mantenga los elementos de carga útil fuera de git cuando contengan datos de clientes.
Utilice claves de idempotencia para una automatización repetible.
Trato aceptado según lo programado, no realizado por el proveedor.

Llamar al público API directamente

API

Cada flujo de trabajo CLI se asigna al público /v1 API. Utilice rutas de autenticación y de alcance de marca Bearer para clientes de automatización.

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

Utilice GET /v1/brand para descubrir marcas accesibles.
Utilice /v1/docs y /v1/openapi.json para el contrato público.
Nunca pegue API keys completo en registros o tickets.

Seguimiento del trabajo después de la aceptación

Estado

La publicación es asíncrona. El API acepta el trabajo validado, lo conserva y programa su ejecución; La finalización del proveedor ocurre más tarde.

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

Los estados esperados incluyen aceptado, en cola, publicando, publicado, fallido y reintento.
Utilice webhooks firmado cuando otro sistema necesite actualizaciones de estado.
El estado operativo permanece en Ankk en lugar del mensaje AI.

Solicitar a las herramientas AI que utilicen Ankk, no que lo reemplacen

Deje que la herramienta AI prepare copias, cargas útiles o comandos. Ankk sigue siendo el sistema de programación y estado.

Codex

Cree una carga útil de lanzamiento Threads a partir de esta nota de la versión, guárdela como tmp/launch-thread.json y luego ejecute ankk contents publish con mi marca configurada.

Claude Code

Inspeccione payload.json en busca de ID de conexión, clave de idempotencia, tipo de sns, texto y programado_for faltantes. Luego muestre el comando ankk contents publish exacto.

ChatGPT

Redacte tres variantes de publicaciones seguras para canales y devuelva una carga útil JSON que pueda pasar a ankk contents publish —file payload.json.

Límites de seguridad

No exponga spk_ API keys completo a modelos, registros, capturas de pantalla ni comentarios de problemas.
No diga a los usuarios que el éxito del comando significa que la publicación del proveedor ya se realizó correctamente.
No documente comandos CLI ocultos o inactivos como funciones públicas.
Utilice API keys, webhooks y verificaciones de estado para la automatización en lugar del acceso directo a la base de datos.

Utilice Ankk de CLI, API, y herramientas AI