A página da Web para a API Icon converte URLs into ícones, tente isso demonstração vê-lo em ação. A API da página da Web no ícone não é simplesmente uma ferramenta de busca de favicon, mas, em vez disso, baseia o ícone final em todos os ícones disponíveis para a página da web. Se nenhum ícone estiver disponível, ele gerará um para a página da web. O ícone de origem escolhido, o plano de fundo e qualquer borda selecionada podem mudar dependendo dos requisitos do usuário.
Para começar a API, substitua o exemplo de texto APPLICATION KEY na chamada abaixo por sua chave de aplicação em seguida, defina o parâmetro size, cujo padrão é 32. Por fim, especifique a página da web que você deseja ativar into um ícone, passando a URL necessária para o parâmetro URL. No exemplo a seguir https://www.astropioneer.blog/ está sendo convertido into um ícone de pixel 48x48.
//api.grabz.it/services/icon?key=Sign in to view your Application Key&size=48&url=https://www.astropioneer.blog/
É uma boa ideia manter o url
parâmetro como o último parâmetro na consultastring pois isso evita que o URL codifique a maioria dos URLs passados para a API da página da Web.
Embora o ícone possa ser baixado com uma linguagem do lado do servidor, como PHP. Também pode ser exibido diretamente em uma página da web ou usado em JavaScript conforme mostrado abaixo. Lembre-se que ao usar a Icon API em uma página web o domínio da página web deve ser adicionado à lista de domínios autorizados.
<img src="//api.grabz.it/services/icon?key=Sign in to view your Application Key&size=48&url=https://www.astropioneer.blog/"/>
<script>
fetch('https://api.grabz.it/services/icon?key=Sign in to view your Application Key&size=48&url=https://www.astropioneer.blog/')
.then(response => response.blob())
.then(blob => {
console.log(blob);
});
</script>
Um ícone também pode ser transformado, basta passar a transformação que você deseja aplicar nas opções abaixo. Um exemplo disso pode ser visto aqui, quando a transformação torna o ícone resultante em sépia.
//api.grabz.it/services/icon?key=Sign in to view your Application Key&transform=sepia&size=48&url=https://www.astropioneer.blog/
A página da Web para a API Icon aceita os quatro parâmetros a seguir.
Nome | Descrição | Opções |
---|---|---|
chave | Sua chave de aplicativo | Este parâmetro é obrigatório para criar um ícone de imagem |
url | O URL da página da Web para converter intoa ícone | Este parâmetro é obrigatório para criar um ícone de imagem |
tamanho | O tamanho do ícone quadrado resultante | Portanto, o 32 resultaria em um ícone 32x32px |
transformar | A transformação a ser aplicada ao ícone resultante. O padrão é nenhum. |
blackandwhite - crie um ícone preto e brancograyscale - crie um ícone em escala de cinzainverse - inverta as cores do íconesepia - crie um ícone colorido sépia |
fonte | Defina a fonte preferida de ícones usados em gerando o ícone finalizado. O padrão é tudo. |
all - use todos os tipos de íconesfavicon - use apenas faviconsmetadata - use apenas os ícones de metadados da página da web |
A página da Web para a API Icon pode retornar os seguintes códigos de erro.
Code | Descrição |
---|---|
100 | Nenhum URL especificado |
103 | Chave de aplicativo ausente |
104 | Chave de aplicativo não reconhecida |
114 | Tamanho do ícone inválido |
401 | O domínio em que esta API está sendo usada deve ser autorizado. |
500 | É necessária uma atualização |