Веб-страница в Icon API конвертирует URL intо иконки, просто попробуйте это демонстрация чтобы увидеть это в действии. API Webpage to Icon не просто захватывает значок favicon, а вместо этого основывает последний значок на всех доступных значках для веб-страницы. Если значки недоступны, они будут созданы для веб-страницы. Выбранный значок источника, фон и любая выбранная граница могут меняться в зависимости от требований пользователя.
Чтобы начать работу с API, замените текстовый пример APPLICATION KEY в приведенном ниже вызове на ключ вашего приложения затем установите параметр размера, который по умолчанию равен 32. Наконец, укажите веб-страницу, которую вы хотите включить into значок, передавая требуемый URL в параметр URL. В следующем примере https://www.astropioneer.blog/ превращается into 48x48 пиксельный значок.
//api.grabz.it/services/icon?key=Sign in to view your Application Key&size=48&url=https://www.astropioneer.blog/
Это хорошая идея, чтобы сохранить url параметр как последний параметр в запросеstring поскольку это позволяет избежать необходимости кодировать URL-адреса большинства URL-адресов, передаваемых на веб-страницу в Icon API.
В то время как Icon можно загрузить с помощью языка на стороне сервера, такого как PHP. Он также может отображаться непосредственно на веб-странице, как показано ниже. Помните, что при использовании Icon API на веб-странице домен веб-страницы должен быть добавлен в список авторизованные домены.
<img src="//api.grabz.it/services/icon?key=Sign in to view your Application Key&size=48&url=https://www.astropioneer.blog/"/>
Значок также можно преобразовать, просто передайте преобразование, которое вы хотите применить, из опций ниже. Примером, который можно увидеть здесь, является то, что преобразование делает результирующий значок сепией.
//api.grabz.it/services/icon?key=Sign in to view your Application Key&transform=sepia&size=48&url=https://www.astropioneer.blog/
API Webpage to Icon принимает следующие четыре параметра.
| Имя и фамилия | Описание | Опции |
|---|---|---|
| ключ | Ваш ключ приложения | Этот параметр обязателен создать значок изображения |
| URL | URL веб-страницы для конвертации intзначок | Этот параметр обязателен создать значок изображения |
| размер | Размер полученного квадратного значка | Таким образом, 32 приведет к значку 32x32px |
| трансформировать | Преобразование для применения к результирующей иконке. По умолчанию нет. |
blackandwhite - создать черно-белый значокgrayscale - создать иконку в оттенках серогоinverse - инвертировать цвета иконкиsepia - создать цветную иконку в виде сепии |
| источник | Определите предпочтительный источник значков, используемых в создание готовой иконки. По умолчанию все. |
all - использовать все типы иконокfavicon - использовать только значкиmetadata - использовать только значки метаданных веб-страницы |
Веб-страница для Icon API может возвращать следующие коды ошибок.
| Code | Описание |
|---|---|
| 100 | URL не указан |
| 103 | Отсутствует ключ приложения |
| 104 | Нераспознанный ключ приложения |
| 114 | Неверный размер значка |
| 401 | Домен, на котором используется этот API, должен быть уполномоченный. |
| 500 | Требуется обновление |