Autenticação
Autentique as solicitações do seu produto ao Beeuni.
Criar um cliente
O SDK chama getToken em cada solicitação. Seu aplicativo gerencia o armazenamento e a renovação dos tokens.
import { createBeeuni } from '@beeuni/sdk';
const beeuni = createBeeuni({
backendUrl: 'https://api.beeuni.ai/v1',
getToken: async () => process.env.BEEUNI_API_KEY ?? null,
});
const projects = await beeuni.projects.list();Escolher uma credencial
- Use uma chave API pessoal para scripts de servidor ou CI. Guarde-a no servidor e escolha o menor escopo disponível.
- Use uma conta de serviço para um agente ou outro chamador não humano. Atribua as funções de projeto necessárias; uma nova conta de serviço não tem acesso a projetos.
- Para um aplicativo que atua em nome dos usuários, use Sign in with Beeuni. O manipulador do servidor gerencia tokens OAuth e sua renovação.
Tratar solicitações rejeitadas
401 indica credenciais ausentes, expiradas ou inválidas. 403 pode indicar permissões insuficientes ou um recurso desativado; leia o código de erro antes de tentar novamente.
Se a função de token armazena em cache um token rotativo, adicione invalidate(rejectedToken). O SDK usa esse callback antes de repetir uma vez a solicitação rejeitada.
Proteger credenciais
Não inclua chaves API de servidor no código do navegador, em URLs ou logs. Use seu servidor ou o proxy OAuth para solicitações do navegador. Revogue credenciais comprometidas em Account → Tokens.