Catálogo
Devolve a lista completa de ícones e categorias em JSON. Use para montar seletores, buscas ou listas no seu próprio sistema.
Requisição
GET
/api/iconsNão recebe parâmetros. A resposta é gerada no build, então volta rápido e pode ficar em cache no seu app.
Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
total | número | Quantidade de ícones. |
categories[].id | texto | Identificador da categoria, como setas. |
categories[].label | texto | Nome para exibir, como Setas. |
categories[].count | número | Ícones nessa categoria. |
icons[].name | texto | Identificador do ícone, usado na URL. |
icons[].category | texto | id da categoria. |
icons[].tags | texto[] | Palavras-chave em português e inglês. |
icons[].url | texto | Caminho do SVG com o estilo padrão. |
Exemplo de resposta
json (resumido)
{ "total": 409, "categories": [ { "id": "interface", "label": "Interface", "count": 46 }, { "id": "setas", "label": "Setas", "count": 39 }, "…" ], "icons": [ { "name": "pasta", "category": "arquivos", "tags": [ "folder", "arquivo", "diretório" ], "url": "/api/icons/pasta" }, { "name": "alternar", "category": "interface", "tags": [ "toggle", "switch", "interruptor", "ligar" ], "url": "/api/icons/alternar" }, "…" ]}Usando com JavaScript
javascript
const res = await fetch("https://glassius.himersus.com/api/icons");const { icons } = await res.json(); const setas = icons.filter((i) => i.category === "setas");