De webpagina naar Icon API converteert URL's into pictogrammen, probeer dit gewoon demonstratie om het in actie te zien. De API voor webpagina naar pictogram is niet alleen een favicon-grabber, maar baseert in plaats daarvan het laatste pictogram op alle beschikbare pictogrammen voor de webpagina. Als er geen pictogrammen beschikbaar zijn, wordt er een voor de webpagina gegenereerd. Het gekozen bronpictogram, de achtergrond en elke geselecteerde rand kunnen veranderen afhankelijk van de gebruikersvereisten.
Om aan de slag te gaan met de API vervangt u het TOEPASSINGSSLEUTEL-tekstvoorbeeld in de onderstaande aanroep door uw applicatiesleutel stel vervolgens de parameter size in, standaard ingesteld op 32. Geef ten slotte de webpagina op die u wilt omslaan into een pictogram, door de vereiste URL door te geven aan de parameter URL. In het volgende voorbeeld https://www.tesla.com wordt omgezet intoa 48x48 pixelpictogram.
//api.grabz.it/services/icon?key=Sign in to view your Application Key&size=48&url=https://www.tesla.com
Het is een goed idee om de url parameter als de laatste parameter in de querystring omdat dit voorkomt dat de meeste URL's die worden doorgegeven aan de webpagina naar Icon API moeten worden gecodeerd.
Terwijl het pictogram kan worden gedownload met een server-side taal zoals PHP. Het kan ook direct op een webpagina worden weergegeven, zoals hieronder wordt getoond. Onthoud dat wanneer u de Icon API in een webpagina gebruikt, het domein van de webpagina moet worden toegevoegd aan de lijst met geautoriseerde domeinen.
<img src="//api.grabz.it/services/icon?key=Sign in to view your Application Key&size=48&url=https://www.tesla.com"/>
Een pictogram kan ook worden getransformeerd, sla gewoon de transformatie over die u wilt toepassen uit de onderstaande opties. Een voorbeeld hiervan is hier te zien waar de transformatie het resulterende pictogram sepia maakt.
//api.grabz.it/services/icon?key=Sign in to view your Application Key&transform=sepia&size=48&url=https://www.tesla.com
De API Webpage to Icon accepteert de volgende vier parameters.
| Naam | Omschrijving | Opties |
|---|---|---|
| sleutel | Uw applicatiesleutel | Deze parameter is vereist om een afbeeldingpictogram te maken |
| url | De URL van de te converteren webpagina intoa pictogram | Deze parameter is vereist om een afbeeldingpictogram te maken |
| grootte | De grootte van het resulterende vierkante pictogram | Dus 32 zou resulteren in een 32x32px-pictogram |
| transformeren | De transformatie die moet worden toegepast op het resulterende pictogram. De standaard is geen. |
blackandwhite - maak een zwart-wit pictogramgrayscale - maak een grijswaardenpictograminverse - keer de kleuren van het pictogram omsepia - maak een sepia gekleurd pictogram |
| (bron) | Definieer de voorkeursbron van pictogrammen die worden gebruikt in het afgewerkte pictogram genereren. De standaardwaarde is alles. |
all - gebruik alle soorten pictogrammenfavicon - gebruik alleen faviconsmetadata - gebruik alleen de metagegevenspictogrammen van de webpagina |
De webpagina naar Icon API kan de volgende foutcodes retourneren.
| Code | Omschrijving |
|---|---|
| 100 | Geen URL opgegeven |
| 103 | Ontbrekende applicatiesleutel |
| 104 | Onbekende applicatiesleutel |
| 114 | Pictogramgrootte ongeldig |
| 401 | Het domein waarop deze API wordt gebruikt, moet zijn bevoegd. |
| 500 | Een upgrade is vereist |