L'API de page Web à icône convertit les URL into icônes, essayez ceci demo pour le voir en action. L’API de page Web à icône n’est pas simplement un outil de saisie d’icônes, mais fonde la dernière icône sur toutes les icônes disponibles pour la page Web. Si aucune icône n'est disponible, elle en générera une pour la page Web. L'icône source choisie, l'arrière-plan et toute bordure sélectionnée peuvent changer en fonction des besoins de l'utilisateur.
Pour commencer à utiliser l’API, remplacez l’exemple textuel APPLICATION KEY dans l’appel ci-dessous par votre clé d'application puis définissez le paramètre size, dont la valeur par défaut est 32. Enfin, spécifiez la page Web que vous souhaitez activer. into une icône, en passant l'URL requise au paramètre d'URL. Dans l'exemple suivant https://www.astropioneer.blog/ est en cours de conversion into une icône de pixel 48x48.
//api.grabz.it/services/icon?key=Sign in to view your Application Key&size=48&url=https://www.astropioneer.blog/
C’est une bonne idée de garder le url paramètre comme dernier paramètre de la requêtestring cela évite d'avoir à coder l'URL de la plupart des URL transmises à la page Web à l'API Icon.
Bien que l’icône puisse être téléchargée avec un langage côté serveur tel que PHP. Il peut également être affiché directement dans une page Web, comme indiqué ci-dessous. Rappelez-vous que lors de l'utilisation de l'API Icon dans une page Web, le domaine de la page Web doit être ajouté à la liste des éléments. domaines autorisés.
<img src="//api.grabz.it/services/icon?key=Sign in to view your Application Key&size=48&url=https://www.astropioneer.blog/"/>
Une icône peut également être transformée en transmettant simplement la transformation que vous souhaitez appliquer à partir des options ci-dessous. Un exemple de cela peut être vu ici où la transformation rend l'icône résultante sépia.
//api.grabz.it/services/icon?key=Sign in to view your Application Key&transform=sepia&size=48&url=https://www.astropioneer.blog/
L'API de page Web à icône accepte les quatre paramètres suivants.
| Nom | Description | Options |
|---|---|---|
| key | Votre clé d'application | Ce paramètre est obligatoire créer une icône d'image |
| url | L'URL de la page Web à convertir into une icône | Ce paramètre est obligatoire créer une icône d'image |
| taille | La taille de l'icône carrée obtenue | Donc, 32 donnerait une icône 32x32px |
| transform | La transformation à appliquer à l'icône résultante. La valeur par défaut est none. |
blackandwhite - créer une icône en noir et blancgrayscale - créer une icône en niveaux de grisinverse - inverser les couleurs de l'icônesepia - créer une icône de couleur sépia |
| la source | Définir la source privilégiée d’icônes utilisées dans générer l'icône terminée. Le défaut est tout. |
all - utiliser tous les types d'icônesfavicon - n'utilisez que des faviconsmetadata - utilisez uniquement les icônes de métadonnées de page Web |
L'API de page Web à icône peut renvoyer les codes d'erreur suivants.
| Code | Description |
|---|---|
| 100 | Aucune URL spécifiée |
| 103 | Clé d'application manquante |
| 104 | Clé d'application non reconnue |
| 114 | Taille de l'icône non valide |
| 401 | Le domaine sur lequel cette API est utilisée doit être autorisé. |
| 500 | Une mise à jour est nécessaire |