Introdução
O que a API pública do Logaco permite fazer e como fazer o primeiro pedido.
A API pública do Logaco dá acesso, a partir do teu código, aos mesmos logótipos e cores que estão no site. É a mesma API que o plugin do Figma, a extensão do Chrome e o servidor MCP usam.
O que podes fazer
| Precisa de token | |
|---|---|
| Pesquisar empresas e logótipos, ver os perfis e os detalhes | Não |
| Pedir a ligação para descarregar um ficheiro (conta para a quota) | Não |
| Ver as cores da marca de uma empresa | Não |
| Listar, guardar, alterar e apagar as tuas paletas | Sim |
| Propor logótipos e ver o estado das tuas propostas | Sim |
Sem token, os pedidos são anónimos. Com um token de acesso, agem em nome da tua conta e os downloads contam para a quota da conta.
O essencial
- Endereço base:
https://api.logaco.com/v1/public - Formato: JSON, em HTTPS. As propostas de logótipos são enviadas em
multipart/form-data, com o ficheiro. - Autenticação: opcional, com o cabeçalho
Authorization: Bearer lgc_…. Vê autenticação e tokens. - Browser: a API aceita pedidos de qualquer origem (CORS), sem cookies. Não ponhas o teu token em código que corre no browser de outras pessoas.
- Especificação: a especificação OpenAPI está em api.logaco.com/v1/public/openapi.json. Importa-a no Postman, no Insomnia ou noutra ferramenta para gerares um cliente.
O primeiro pedido
Pesquisa empresas com «vodacom» no nome. Não precisas de token:
curl "https://api.logaco.com/v1/public/companies?q=vodacom"A resposta traz a lista em data, com o slug de cada empresa, o logótipo
actual (currentLogo) e a página no Logaco. Vê a resposta completa em
pesquisar empresas.
Descarregar um logótipo
Descarregar é um processo em três passos:
Encontra o logótipo
Usa pesquisar empresas ou
pesquisar logótipos e guarda o
slug (ou o id) do logótipo.
Vê os formatos
GET /logos/{id} devolve as
variantes e os formatos disponíveis, sem ligações. Não conta para a quota.
Pede a ligação
POST /logos/{id}/download
com o formato que queres. A resposta traz uma ligação temporária (url),
válida durante 1 hora, e o estado da tua quota. Descarrega o ficheiro
dessa ligação: vem directamente do armazenamento do Logaco.
curl -X POST "https://api.logaco.com/v1/public/logos/vodacom/download" \
-H "Content-Type: application/json" \
-d '{"format": "SVG"}'Paginação
As listas são paginadas com page (a partir de 1) e pageSize (por omissão
20, no máximo 50). A resposta diz em que página estás e quantas há:
{ "data": [], "page": 1, "pageSize": 20, "total": 37, "totalPages": 2 }Identificar o teu cliente
Sem token, podes dizer de onde vem o pedido com o cabeçalho
X-Logaco-Source (API, MCP, FIGMA ou CHROME; por omissão, API).
Com token, vale a origem escolhida ao criar o token.