Visão geral

A interface de linha de comando oficial da Selectwin — autentique, chame qualquer endpoint e opere seus recursos direto do terminal. Escrita em TypeScript sobre o @selectwin/sdk.

O pacote @selectwin/cli (binário selectwin) dá aos integradores uma ferramenta de grau-produto para explorar e operar a API: perfis de autenticação, um escape-hatch que cobre 100% do spec (get/post/put/patch/delete), comandos curados para os fluxos quentes, saída em tabela ou JSON (pipe-friendly com jq) e exit codes estáveis por tipo de erro.

Destaques

• Login por perfil — selectwin login grava a SelectKey em ~/.selectwin/config.toml (permissão 0600); alterne com --profile.
• Chame qualquer endpoint — selectwin get /v1/transactions, selectwin post /v1/... -d '{…}'.
• Comandos curados — transactions, customers, webhooks (endpoints + test).
• Saída — tabela colorida por padrão; --json cospe o corpo cru.
• Idempotência automática em mutações; --idempotency-key sobrescreve.

Em breve: selectwin listen (encaminhar webhooks para o localhost, verificando o HMAC) e selectwin trigger (disparar eventos de teste) dependem de streaming novo no backend. Hoje, selectwin webhooks test envia um webhook.ping sintético ao seu endpoint.

Exemplo rápido

npm install -g @selectwin/cli
selectwin login                       # cole sua sk_test_… / sk_live_…
selectwin whoami                      # valida a chave e mostra conta/ambiente
selectwin get /v1/transactions --limit 5

Próximos passos

• Instalação — instalar e autenticar.
• Quickstart — primeiras chamadas, recursos e webhooks.

Código-fonte no GitHub · pacote no npm.