A CLI do CometAPI lê configurações de um arquivo de configuração TOML, de variáveis de ambiente e de flags de linha de comando. Quando a mesma configuração está disponível em várias fontes, a ordem de prioridade é:
Flags da CLI > arquivo de configuração > variáveis de ambiente > padrões
Arquivo de configuração
Localização: ~/.config/cometapi/config.toml
Execute o assistente de configuração para criar o arquivo de configuração de forma interativa:
Ou gerencie configurações individuais com o subcomando config:
Configurações disponíveis
Credenciais
A CLI usa dois tipos de credenciais:
API key
Obrigatória para todos os comandos. A API key autentica requisições para os endpoints de modelo do CometAPI.
Crie uma API key em CometAPI Console → API Keys.
Defina-a de uma destas formas:
Access token
Opcional. O access token é necessário para comandos em nível de conta: account, stats, tokens, logs e tasks.
Gere um access token em CometAPI Console → Personal Settings.
Defina-o de uma destas formas:
Segurança
A CLI aplica as seguintes práticas de segurança:
- API keys e access tokens nunca são registrados em log nem exibidos por completo. Apenas os últimos 4 caracteres são mostrados na saída de diagnóstico.
- O arquivo de configuração é criado com permissões restritivas (
0600) — legível apenas pelo proprietário do arquivo.
- As credenciais nunca devem ser commitadas no controle de versão. Adicione o caminho do arquivo de configuração ao seu
.gitignore, se aplicável.
Você é responsável por todo o uso e pelos custos gerados com suas API keys. Mantenha suas chaves seguras e faça a rotação delas se suspeitar de acesso não autorizado.
Solução de problemas
