O Icons8 fornece a possibilidade de incorporar ícones em sua página da web e renderizá-los através de nossa API.
Atualmente, a renderização de ícones requer autenticação com uma chave API, com exceção de ícones gratuitos (.png abaixo de 100px).
Existem duas maneiras de solicitar um ícone:
1) Especificando o ID de um ícone. Os IDs podem ser recebidos por meio de nossa segunda API conforme descrito aqui e aqui.
O link básico é:
GET https://api-img.icons8.com/?token=user_token&id=icon_id
Ele retornará um ícone com parâmetros padrão aplicados.
Você pode modificar os parâmetros de consulta ao adicioná-los ao link separado pelo caractere &:
token - obrigatório - sua chave API.
icon_id - obrigatório - ver acima.
size - opcional - o ícone será pixel perfect se não for especificado. Tanto o número de pixels (ou seja, 512) quanto um multiplicador (2x, 3x etc.) funcionarão.
format - opcional - produzirá .PNG se não for especificado. Nosso renderizador suporta os formatos .PNG, .SVG, .PDF, .GIF, .AEP e .JSON.
color - opcional - especificado em HEX (sem o caractere #) e funciona apenas para ícones monocromáticos.
Por exemplo, para obter um ícone HDD .svg vermelho de 512px no estilo Dotty, a solicitação será:
GET https://api-img.icons8.com/?token=user_token&id=44082&size=512&format=svg&color=FF2400
Embora uma solicitação sem os parâmetros obrigatórios retorne um erro, a ordem dos parâmetros de consulta não é importante.
2) Especificando o estilo e o nome de um ícone específico.
Aqui, os parâmetros são separados por barra:
GET https://api-img.icons8.com/platform/size/color/name.format?token=user_token
token - obrigatório - sua Chave de API.
name - obrigatório - pode ser recebido por meio de uma solicitação de pesquisa.
platform - opcional - gerará ícones no estilo iOS7 por padrão. Os nomes dos estilos podem ser solicitados via API ou é possível vê-los na barra de endereço ao navegar pelos estilos.
format - opcional - produzirá .PNG se não for especificado. Nosso renderizador suporta os formatos .PNG, .SVG, .PDF, .GIF, .AEP e .JSON.
color - opcional - especificado em HEX (sem o caractere #) e funciona apenas para ícones monocromáticos.
Para obter um ícone Key .svg verde de 128px no estilo Material Outlined, a solicitação será:
GET https://api-img.icons8.com/material-outlined/128/2AE468/key-security.svg?token=user_token
Se o nome do ícone ou estilo consistir em duas ou mais palavras, use um hífen para separá-las. Por exemplo: left-arrow.