Node.js
Instalação
Instale o @selectwin/sdk com seu gerenciador de pacotes favorito. Requer Node 18+ (que traz fetch global); também roda em edge/workers, Bun e Deno.
Instale o @selectwin/sdk com seu gerenciador de pacotes favorito. Requer Node 18+ (que traz fetch global); também roda em edge/workers, Bun e Deno.
Instalar
npm install @selectwin/sdk
# pnpm add @selectwin/sdk · yarn add @selectwin/sdk · bun add @selectwin/sdkOs tipos TypeScript já vêm no pacote — nada de @types separado.
Configurar o cliente
Toda requisição autentica com sua SelectKey no header SelectKey. Use sk_test_… no sandbox e sk_live_… em produção — o ambiente é resolvido pela própria chave. Nunca exponha a chave no front-end; guarde-a como variável de ambiente.
import { Selectwin } from '@selectwin/sdk';
const sw = new Selectwin(process.env.SELECTWIN_API_KEY!);Opções
const sw = new Selectwin(process.env.SELECTWIN_API_KEY!, {
maxRetries: 2, // tentativas em 429/5xx/rede (padrão 2)
timeoutMs: 60_000, // timeout por requisição (padrão 60s; 0 desativa)
baseUrl: 'https://api.selectwin.io', // sobrescreva para um mock/staging
fetch: undefined, // injete um fetch customizado (edge/workers/testes)
userAgent: undefined, // sobrescreve o User-Agent
});A
baseUrlpadrão éhttps://api.selectwin.io. O SDK acrescenta o prefixo de versão (/v1) automaticamente.
Próximos passos
- Quickstart — sua primeira cobrança em minutos.
How is this guide?