Autenticação e tokens
Cria, guarda e revoga os tokens de acesso à API.
A API funciona sem token para pesquisar, ver logótipos e cores e descarregar (com a quota sem conta). Com um token de acesso, os pedidos agem em nome da tua conta: os downloads contam para a quota da conta e passas a poder usar as paletas e as propostas.
Usar o token
Envia o token no cabeçalho Authorization, em todos os pedidos:
Authorization: Bearer lgc_…Os tokens começam por lgc_. Não há outra forma de autenticação: a API não
usa cookies nem chaves na URL.
Criar um token
Abre os acessos da tua conta
No site do Logaco, com sessão iniciada, vai a Perfil → Acessos e integrações e clica em Novo token.
Preenche os dados
| Campo | O que escolher |
|---|---|
| Nome | Para o reconheceres na lista, por exemplo «Script de relatórios» (até 60 caracteres) |
| Para que é | API / scripts (ou Assistente de IA (MCP), para um assistente de IA) |
| Permissões | Só as que o teu código precisa (ver abaixo) |
| Validade | 7 dias, 30 dias, 90 dias, 1 ano ou sem validade |
Copia o token
Clica em Criar token. O token aparece uma única vez: copia-o e guarda-o num sítio seguro. Se o perderes, revoga-o e cria outro.
Cada conta pode ter até 20 tokens activos ao mesmo tempo.
Permissões
| Permissão | Nome no site | Para quê |
|---|---|---|
read:logos | Ler logótipos e empresas | Pesquisar e descarregar com a quota da conta |
read:palettes | Ler as minhas paletas | Listar e ver paletas |
write:palettes | Guardar paletas | Criar, alterar e apagar paletas |
write:proposals | Propor logótipos | Propor logótipos e ver as tuas propostas |
Dá a cada token só as permissões de que precisa. Se um pedido precisar de uma
permissão que o token não tem, a API responde 403 INSUFFICIENT_SCOPE.
Pesquisar com token
Os endpoints de logótipos e empresas funcionam sem token. Mas, se enviares um
token, ele precisa da permissão read:logos.
Guardar o token com segurança
Trata o token como uma palavra-passe: quem o tiver age em nome da tua conta, dentro das permissões que lhe deste.
- Guarda-o numa variável de ambiente ou num gestor de segredos, nunca no código.
- Não o publiques num repositório, mesmo privado.
- Não o uses em código que corre no browser de outras pessoas: qualquer um o poderia ler.
- Usa uma validade curta para testes.
export LOGACO_TOKEN="lgc_…"
curl "https://api.logaco.com/v1/public/me" -H "Authorization: Bearer $LOGACO_TOKEN"Verificar um token
GET /me diz se o pedido está
autenticado e, com token, de que conta é, o nome e o início do token, as
permissões, a origem e a validade. Sem token, responde
{ "authenticated": false }.
Revogar um token
- No site: em Perfil → Acessos e integrações, clica em Revogar no token e confirma. Deixa de funcionar imediatamente e não pode ser reactivado.
- Pela API:
DELETE /me/tokenrevoga o token usado nesse pedido. É o que o plugin e a extensão fazem quando clicas em Sair.
Na lista do site vês, para cada token, o estado (Activo, Revogado ou Expirado), as permissões e quando foi usado pela última vez.
Tokens dos plugins e dos assistentes
Não precisas de criar tokens à mão para o plugin do Figma, a extensão do Chrome ou um assistente de IA ligado com conta: o login cria-os sozinho. Também aparecem em Acessos e integrações, onde os podes revogar.
Erros de autenticação
| Estado | Código | Quando |
|---|---|---|
| 401 | INVALID_TOKEN | O token não existe ou está mal escrito |
| 401 | TOKEN_REVOKED | O token foi revogado |
| 401 | TOKEN_EXPIRED | O token passou da validade |
| 401 | TOKEN_REQUIRED | O endpoint precisa de token e o pedido não tem |
| 403 | INSUFFICIENT_SCOPE | O token não tem a permissão que o endpoint precisa |
Vê todos os códigos em limites, quotas e erros.