Referência da API
Todos os endpoints da API pública, gerados a partir da especificação OpenAPI.
Cada endpoint da API pública tem a sua página, com os parâmetros, o corpo do pedido, a resposta e exemplos em cURL, JavaScript e Python. As páginas são geradas a partir da especificação OpenAPI, por isso acompanham o que a API faz.
Endereço base: https://api.logaco.com/v1/public
Sobre os exemplos
Os dados dos exemplos (como a «Empresa Exemplo») são fictícios. As respostas reais têm a mesma forma.
Empresas
Sem conta| Endpoint | O que faz |
|---|---|
GET /companies | Pesquisar empresas com logótipos |
GET /companies/{slug} | Uma empresa e os seus logótipos |
GET /companies/{slug}/colors | As cores da marca |
GET /domains | Os sites das empresas, para comparar endereços |
Logótipos
Sem conta| Endpoint | O que faz |
|---|---|
GET /logos | Pesquisar logótipos |
GET /logos/{id} | Variantes e formatos de um logótipo |
POST /logos/{id}/download | A ligação para descarregar um ficheiro (conta para a quota) |
Paletas
Precisa de conta| Endpoint | O que faz |
|---|---|
GET /palettes | As tuas paletas e gradientes |
POST /palettes | Guardar uma paleta ou um gradiente |
GET /palettes/{id} | Uma paleta tua, ou pública de outra pessoa |
PATCH /palettes/{id} | Alterar uma paleta tua |
DELETE /palettes/{id} | Apagar uma paleta tua |
Propostas
Precisa de conta| Endpoint | O que faz |
|---|---|
POST /proposals | Propor um logótipo (novo, ou uma versão nova) |
GET /proposals | As tuas propostas e o estado de cada uma |
Conta
| Endpoint | O que faz |
|---|---|
GET /me | Verificar o token (ou confirmar que o pedido é anónimo) |
DELETE /me/token | Revogar o token usado no pedido |
POST /device/code | Pedir um código de ligação (plugins) |
POST /device/token | Receber o token depois de o código ser confirmado |
Antes de começares, lê a introdução, a autenticação e os limites e erros.
Limites, quotas e erros
Limites de pedidos, quota de downloads e os códigos de erro da API.
Pesquisar empresas com logótipos GET
Pesquisa no nome e nos nomes alternativos, sem distinguir acentos. Paginado (máx. 50 por página). Com related=true junta, em related, empresas relacionadas por significado (ex.: «telemóvel» → operadoras).