Gerar Chave API — Declara API

POSThttps://declara-web.vercel.app/api/v1/keys

A chave é exibida apenas uma vez. Se perdida, desative e gere uma nova.

Cada empresa pode ter no máximo 5 chaves ativas simultaneamente.

Body

nomestringobrigatório

Nome descritivo para identificar a chave. Ex: "HS Financeiro", "Sistema ERP".

Resposta

idstringUUID da chave recém-criada

keystringA chave API completa. Exibida apenas nesta resposta.

nomestringNome atribuído à chave

created_atstringData de criação (ISO 8601)

Exemplos

curl -X POST "https://declara-web.vercel.app/api/v1/keys" \
  -H "Content-Type: application/json" \
  -H "Cookie: sb-session=..." \
  -d '{"nome": "HS Financeiro"}'

const res = await fetch('https://declara-web.vercel.app/api/v1/keys', {
  method:      'POST',
  credentials: 'include',
  headers:     { 'Content-Type': 'application/json' },
  body:        JSON.stringify({ nome: 'HS Financeiro' }),
});

const { key, id } = await res.json();
// Salve a chave agora — não será exibida novamente!
console.log('Chave gerada:', key);

Sucesso (201)

JSON

{
  "id":         "c56a4180-65aa-42ec-a945-5fd21dec0538",
  "key":        "sk_declara_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6",
  "nome":       "HS Financeiro",
  "created_at": "2026-07-02T10:00:00.000Z"
}

Limite atingido (429)

JSON

{ "error": "Limite de 5 chaves ativas atingido. Desative uma antes de criar outra." }