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.tesla.com 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.tesla.com
É 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.
Enquanto o ícone pode ser baixado com uma linguagem do lado do servidor, como PHP. Também pode ser exibido diretamente em uma página da web, como mostrado abaixo. Lembre-se de que ao usar a API Icon em uma página da web, o domínio da página 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.tesla.com"/>
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.tesla.com
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.
| Código | 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 |