تحول صفحة الويب إلى رمز API عنوان URL intيا الرموز ، فقط حاول هذا عرض لرؤيتها في العمل. لا تعد Web Page to Icon API مجرد أداة إمساك favicon ، ولكنها تقوم بدلاً من ذلك ببناء الرمز النهائي على جميع الرموز المتاحة لصفحة الويب. إذا لم تتوفر رموز ، فسيؤدي ذلك إلى إنشاء رمز لصفحة الويب. يمكن تغيير رمز المصدر الذي تم اختياره والخلفية وأي حدود محددة بناءً على متطلبات المستخدمين.
للبدء في استخدام واجهة برمجة التطبيقات ، استبدل مثال النص "التطبيق الأساسي" في المكالمة أدناه بـ مفتاح التطبيق الخاص بك ثم قم بتعيين المعلمة الحجم ، والتي الافتراضية إلى 32. أخيرًا حدد صفحة الويب التي تريد تشغيلها into رمز ، عن طريق تمرير URL المطلوب إلى معلمة URL. في المثال التالي https://www.tesla.com يتم تحويلها intيا أيقونة 48x48 بكسل.
//api.grabz.it/services/icon?key=Sign in to view your Application Key&size=48&url=https://www.tesla.com
انها فكرة جيدة للحفاظ على url المعلمة كالمعلمة الأخيرة في الاستعلامstring لأن هذا يتجنب الاضطرار إلى تشفير URL لمعظم عناوين URL التي تم تمريرها إلى صفحة الويب إلى Icon API.
بينما يمكن تنزيل هذا الرمز بلغة من جانب الخادم مثل PHP. يمكن أيضًا عرضها مباشرة في صفحة ويب كما هو موضح أدناه. تذكر أنه عند استخدام Icon API في صفحة ويب ، يجب إضافة مجال صفحة الويب إلى قائمة المجالات المصرح بها.
<img src="//api.grabz.it/services/icon?key=Sign in to view your Application Key&size=48&url=https://www.tesla.com"/>
يمكن أيضًا تحويل رمز ما ، فقط قم بتمرير التحويل الذي تريد تطبيقه من الخيارات أدناه. مثال على ذلك يمكن رؤيته هنا حيث أن التحويل يجعل الأيقونة الناتجة بني داكن.
//api.grabz.it/services/icon?key=Sign in to view your Application Key&transform=sepia&size=48&url=https://www.tesla.com
تقبل صفحة الويب إلى Icon API المعلمات الأربعة التالية.
| الاسم | الوصف | الخيارات |
|---|---|---|
| مفتاح | مفتاح التطبيق الخاص بك | هذه المعلمة مطلوبة لإنشاء أيقونة الصورة |
| URL | عنوان url لصفحة الويب للتحويل intيا أيقونة | هذه المعلمة مطلوبة لإنشاء أيقونة الصورة |
| المقاسات | حجم رمز المربع الناتج | لذلك سينتج عن 32 أيقونة 32x32px |
| تحول | التحويل لتطبيقه على الأيقونة الناتجة. الافتراضي هو لا شيء. |
blackandwhite - إنشاء رمز أبيض وأسودgrayscale - إنشاء رمز تدرج الرماديinverse - قلب ألوان الأيقونةsepia - إنشاء أيقونة ملونة بني داكن |
| مصدر | حدد المصدر المفضل للرموز المستخدمة في توليد الأيقونة النهائية. الافتراضي هو كل شيء. |
all - استخدم جميع أنواع الأيقوناتfavicon - استخدم فقط faviconsmetadata - استخدم فقط الرموز الوصفية لصفحة الويب |
يمكن لصفحة الويب إلى رمز واجهة برمجة التطبيقات إرجاع رموز الخطأ التالية.
| رمز | الوصف |
|---|---|
| 100 | لا عنوان URL محدد |
| 103 | مفتاح التطبيق مفقود |
| 104 | مفتاح التطبيق غير معروف |
| 114 | حجم الرمز غير صالح |
| 401 | يجب أن يكون المجال الذي يتم استخدامه على API هذا مخول. |
| 500 | مطلوب ترقية |