Crie uma conta

Tudo começa em app.stackin.io — cadastre-se e faça login. Não existe uma conta "de desenvolvedor" separada: o mesmo login é usado no dashboard onde você gerencia empresas, keys e cobrança.

Antes de criar uma key, registre uma empresa — não dá pra pular esse passo, é a identidade sob a qual todo documento é emitido (CNPJ, endereço, regime tributário). Uma conta pode ter várias empresas, cada uma com suas próprias keys e seu próprio saldo de créditos.

Na tela Settings → API key da empresa, crie uma key e escolha o contexto: sdk se você vai usar uma das bibliotecas cliente oficiais, ou api se vai chamar a API REST diretamente com um token Bearer. O contexto é fixo pelo resto da vida da key e decide qual superfície ela autentica — uma key com contexto sdk não funciona como header Authorization de API crua, e vice-versa.

Escolha também o ambiente da key — homologation ou production, padrão homologation — fixado na criação junto com o contexto. Uma empresa pode ter até 3 keys no total, qualquer mix de contexto e ambiente. Veja Ambientes pra como essa escolha afeta cada requisição.

Copie a key imediatamente depois de criar — ela é mostrada uma única vez, na criação, e não pode ser recuperada depois. Se perder, o jeito é revogar e criar outra, não tentar buscar depois.

Uma coisa que a key sozinha não libera: emitir um documento de fato exige que o certificado digital da empresa (.pfx/.p12) já esteja enviado, já que é ele quem assina o documento pro autorizador do governo. A key pode ser criada e usada pra chamadas de leitura antes disso, mas a emissão vai falhar sem o certificado.