Ankk CLI/API Guia do desenvolvedor

Início rápido

Um pequeno caminho que comprova o pacote, API key, e o fluxo de trabalho de publicação com escopo de marca.

Instale ou execute uma vez

O pacote público é @anakonn/ankk e o binário é ankk. O CLI atualmente requer Bun.

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

Configurar com segurança

Use um API key de Ankk. A saída do comando redige a chave completa e as variáveis de ambiente funcionam 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 conteúdo preparado

Crie uma carga JSON e entregue-a ao mesmo contrato de agendamento público usado pelos 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 em vez de reconstruir formulários

Carga útil

Use —file para corpos de conteúdo para que scripts e ferramentas AI possam produzir cargas estruturadas sem uma pilha frágil de sinalizadores.

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

Mantenha os fixtures de carga útil fora do git quando eles contiverem dados do cliente.
Use chaves de idempotência para automação repetível.
Tratamento aceito conforme programado, mas não bem-sucedido pelo provedor.

Chame o API público diretamente

API

Cada fluxo de trabalho CLI é mapeado de volta para o público /v1 API. Use autenticação Bearer e rotas com escopo de marca para clientes de automação.

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

Use GET /v1/brand para descobrir marcas acessíveis.
Use /v1/docs e /v1/openapi.json para o contrato público.
Nunca cole API keys completo em logs ou tickets.

Acompanhe o trabalho após aceitação

Estado

A publicação é assíncrona. O API aceita trabalho validado, persiste e agenda a execução; a conclusão do provedor acontece mais tarde.

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

Os estados esperados incluem aceito, enfileirado, publicação, publicado, falha e nova tentativa.
Use webhooks assinado quando outro sistema precisar de atualizações de status.
O status operacional permanece em Ankk em vez do prompt AI.

Solicitar às ferramentas AI para usar Ankk, não substituí-lo

Deixe a ferramenta AI preparar cópias, cargas úteis ou comandos. Ankk continua sendo o sistema de agendamento e status.

Codex

Crie uma carga útil de inicialização Threads a partir desta nota de versão, salve-a como tmp/launch-thread.json e execute ankk contents publish com minha marca configurada.

Claude Code

Inspecione payload.json em busca de connection_id, idempotency_key, sns_type, text e Scheduled_for ausentes. Em seguida, mostre o comando ankk contents publish exato.

ChatGPT

Elabore três variantes de postagem seguras para canais e retorne uma carga JSON que posso passar para ankk contents publish —file payload.json.

Limites de segurança

Não exponha spk_ API keys completo a modelos, registros, capturas de tela ou comentários de problemas.
Não diga aos usuários que o sucesso do comando significa que a publicação do provedor já foi bem-sucedida.
Não documente comandos CLI ocultos ou inativos como recursos públicos.
Use API keys, webhooks e verificações de status para automação em vez de acesso direto ao banco de dados.

Use Ankk de CLI, API, Ferramentas e AI