Instalação

Instale a CLI globalmente com o npm. Requer Node 18+. O binário instalado é selectwin.

Instalar

npm install -g @selectwin/cli
selectwin --version

Autenticar

selectwin login cola sua SelectKey e a grava num perfil em ~/.selectwin/config.toml (permissão 0600). Use sk_test_… para o sandbox e sk_live_… para produção — o ambiente é resolvido pela própria chave.

selectwin login                 # perfil "default"
selectwin login --profile prod  # um perfil separado para produção
selectwin whoami                # valida a chave e mostra conta/ambiente

Perfis e precedência da chave

selectwin config list           # lista os perfis
selectwin config use prod       # define o perfil ativo
selectwin logout                # remove o perfil ativo

A chave usada em cada chamada segue esta ordem de precedência:

1. --api-key sk_… (flag)
2. $SELECTWIN_API_KEY (variável de ambiente)
3. perfil ativo do config.toml

Flags globais

--profile <nome> · --api-key <chave> · --json · --no-color · --live / --sandbox · --idempotency-key <uuid> · -v / --verbose.

A chave nunca é logada por inteiro (é mascarada como sk_live_…abcd). O arquivo de config é criado com permissão 0600.

Próximos passos

• Quickstart — primeiras chamadas em minutos.