Pular para conteúdo principal
Predators Protocol · O olho que nunca se fecha · bloodPredatorsProtocolThe eye that never closes

Documentação · API

Invoque a frota por API

Os 65 predadores em 10 camadas respondem por um endpoint só: POST /api/invoke. A chave Bearer age com o seu acesso e gasta a sua quota.

1 · Crie sua chave

Em /settings (planos PRO e APEX), seção Chaves de API, crie uma chave. Ela aparece uma única vez na tela — copie e guarde num lugar seguro, porque depois ela fica mascarada e não dá pra ver de novo. A chave usa o seu plano: a mesma quota e as mesmas camadas, nada a mais. No plano FREE a seção não aparece — faça upgrade pra liberar o acesso por API.

2 · Invoque por curl

Envie o predator_id e a task com a chave no header Authorization:
curl -X POST https://predadores.online/api/invoke \
  -H "Authorization: Bearer OWN_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{"predator_id":"aguia-real","task":"priorize estas tres frentes do trimestre"}'

A resposta é um JSON com a saída do predador no campo result. Se vier 401, a chave está errada ou foi revogada — gere outra em /settings. Se vier 403, seu plano não inclui a camada desse predador.

3 · Invoque pela CLI (npx)

A CLI usa a mesma chave (variável de ambiente PREDATORS_API_KEY):
export PREDATORS_API_KEY="OWN_sua_chave"
npx predators-protocol invoke aguia-real "priorize estas tres frentes do trimestre"

4 · Limites e segurança

Cada turno é uma invocação e conta na sua quota semanal. Há limite de 30 chamadas por minuto por chave. A chave nunca é armazenada em texto pelo servidor (só o hash). Revogue qualquer chave em /settings — ela para de funcionar na hora.

O comando npx invoke acima já funciona. A integração mais profunda da CLI com o VS Code ainda está em construção. Veja também o produto Dev e os planos.