آئکن API میں ویب پیج یو آر ایل کو تبدیل کرتا ہے intاے شبیہیں ، صرف اس کی کوشش کریں ڈیمو اسے عمل میں دیکھنا ہے۔ آئکن API میں ویب صفحہ صرف ایک ویب شبیہ ساز نہیں ہے ، بلکہ اس کے بجائے ویب کے صفحے کے لئے دستیاب تمام شبیہیں پر حتمی آئکن کی بنیاد رکھتا ہے۔ اگر کوئی شبیہیں دستیاب نہیں ہیں تو یہ ویب پیج کیلئے ایک تخلیق کرے گا۔ سورس آئیکون کا انتخاب ، پس منظر اور منتخب کردہ کوئی بھی سرحد صارفین کی ضروریات کے مطابق تبدیل ہوسکتی ہے۔
API کے ساتھ شروع کرنے کے لئے مندرجہ ذیل کال میں اپلی کیشن کلیدی متن مثال کی جگہ لیں آپ کی درخواست کی کلید پھر سائز کا پیرامیٹر مرتب کریں ، جو 32 پر ڈیفالٹ ہوتا ہے۔ آخر میں وہ ویب صفحہ بتائیں جسے آپ تبدیل کرنا چاہتے ہیں intاے آئیکن ، مطلوبہ یو آر ایل کو پیرامیٹر میں منتقل کرکے۔ مندرجہ ذیل مثال میں https://www.astropioneer.blog/ تبدیل کیا جارہا ہے intoa 48x48 پکسل کا آئیکن۔
//api.grabz.it/services/icon?key=Sign in to view your Application Key&size=48&url=https://www.astropioneer.blog/
یہ رکھنا ایک اچھا خیال ہے url سوال میں آخری پیرامیٹر کے طور پر پیرامیٹرstring چونکہ یہ URL کو انکوڈ کرنے سے بچتا ہے زیادہ تر یو آر ایل کو آئکن API میں ویب پیج پر منتقل کیا جاتا ہے۔
جب کہ آئکن کو سرور سائڈ لینگوئج جیسے پی ایچ پی سے ڈاؤن لوڈ کیا جاسکتا ہے۔ جیسا کہ ذیل میں دکھایا گیا ہے اسے براہ راست ویب پیج میں بھی دکھایا جاسکتا ہے۔ یاد رکھیں کہ جب کسی ویب پیج میں آئکن 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 میں ویب صفحہ مندرجہ ذیل چار پیرامیٹرز کو قبول کرتا ہے۔
| نام | تفصیل | آپشنز کے بھی |
|---|---|---|
| کلید | آپ کی درخواست کی | اس پیرامیٹر کی ضرورت ہے ایک تصویری آئکن بنانے کے لئے |
| یو آر ایل | تبدیل کرنے کے لئے ویب پیج کا یو آر ایل intOA آئکن | اس پیرامیٹر کی ضرورت ہے ایک تصویری آئکن بنانے کے لئے |
| سائز | نتیجے میں مربع آئکن کا حجم | تو 32 کے نتیجے میں 32x32px آئیکن ہوگا |
| تبدیل | تبدیلی والے آئکن پر لاگو ہونے کے لئے۔ پہلے سے طے شدہ کوئی نہیں ہے۔ |
blackandwhite - ایک سیاہ اور سفید آئکن بنائیںgrayscale - گرے اسکیل آئیکن بنائیںinverse - آئکن کے رنگ الٹ دیںsepia - سیپیا رنگ کا آئکن بنائیں |
| ذرائع | میں استعمال شدہ شبیہیں کے ترجیحی منبع کی وضاحت کریں تیار شبیہہ تیار کرنا۔ پہلے سے طے شدہ سب ہے۔ |
all - آئیکن کی تمام اقسام کا استعمال کریںfavicon - صرف ویب سائٹ استعمال کریںmetadata - صرف ویب پیج میٹا ڈیٹا شبیہیں استعمال کریں |
آئکن API میں ویب صفحہ مندرجہ ذیل خرابی کوڈوں کو واپس کرسکتا ہے۔
| ضابطے | تفصیل |
|---|---|
| 100 | کوئی URL متعین نہیں ہے |
| 103 | لاپتہ ایپلیکیشن کی |
| 104 | غیر شناخت شدہ درخواست کی |
| 114 | شبیہہ سائز غلط ہے |
| 401 | اس API کا جس ڈومین پر استعمال ہورہا ہے وہ ہونا چاہئے مجاز. |
| 500 | ایک اپ گریڈ کی ضرورت ہے |