ממשק API של דף האינטרנט לאייקון ממיר כתובות URL into סמלים, פשוט נסה זאת הדגמה לראות את זה בפעולה. ממשק ה- API של דף האינטרנט לאייקון הוא לא סתם חוטף favicon, אלא מבסס את הסמל הסופי על כל הסמלים הזמינים לדף האינטרנט. אם אין סמלים זמינים זה יפיק אחד לדף האינטרנט. סמל המקור שנבחר, הרקע וכל גבול שנבחר יכולים להשתנות בהתאם לדרישות המשתמשים.
כדי להתחיל עם ה- API, החלף את דוגמת הטקסט של יישום המפתח בשיחה שלהלן באמצעות מפתח היישום שלך ואז קבע את פרמטר הגודל, אשר כברירת מחדל הוא 32. לבסוף ציין את דף האינטרנט שאתה רוצה להפוך into סמל, על ידי העברת כתובת האתר הנדרשת לפרמטר URL. בדוגמה הבאה https://www.tesla.com מומר into סמל פיקסל של 48x48.
https://www.tesla.com
//api.grabz.it/services/icon.ashx?key=Sign in to view your Application Key&size=48&url=https://www.tesla.com
כדאי לשמור על url פרמטר כפרמטר האחרון בשאילתהstring מכיוון שהדבר מונע את הצורך בקידוד ה- URL לרוב כתובות האתר המועברות לדף האינטרנט ל- API של אייקון.
url
אמנם ניתן להוריד את האייקון זה בשפה בצד השרת כגון PHP. זה יכול להיות מוצג ישירות בדף אינטרנט כמוצג להלן. זכור כי בעת השימוש ב- Icon API בדף אינטרנט יש להוסיף את התחום של דף האינטרנט לרשימה של תחומים מורשים.
<img src="//api.grabz.it/services/icon.ashx?key=Sign in to view your Application Key&size=48&url=https://www.tesla.com"/>
ניתן לשנות אייקון רק לעבור את השינוי שברצונך ליישם מהאפשרויות שלהלן. דוגמה לכך ניתן לראות כאן היה הטרנספורמציה שהופכת את האייקון שנוצר כתוצאה מכך.
//api.grabz.it/services/icon.ashx?key=Sign in to view your Application Key&transform=sepia&size=48&url=https://www.tesla.com
ממשק ה- API לדף האייקון מקבל את ארבעת הפרמטרים הבאים.
blackandwhite
grayscale
inverse
sepia
all
favicon
metadata
ממשק API לדף האייקון יכול להחזיר את קודי השגיאה הבאים.