المطوّرون

واجهة IconHub البرمجية

ابحث عن الأيقونات وخصّصها وقدّمها من داخل منتجك. مجانًا بمفتاح API، مع حدود استخدام عادل تُبقيها سريعة للجميع.

REST + JSONSVG مُنقّى مضمّنمعاينات AVIFمجاني بمفتاح API300 طلب/دقيقة

curl "https://admin.iconhub.com/api/v1/icons?search=heart&with=svg,styles&per_page=20" \
  -H "Authorization: Bearer $ICONHUB_TOKEN" \
  -H "Accept: application/json"

الاستجابة

{
  "data": [
    { "id": 14162379, "type": "Icon", "name": "Heart", "slug": "heart",
      "static_image_url": "https://storage.iconhub.com/icons/heart-14162379.avif",
      "svg": { "svg_code": "<svg …>" }, "styles": [{ "name": "Lineal", "slug": "lineal" }] }
  ],
  "pagination": { "current_page": 1, "last_page": 11733, "limit": 20, "total": 234649 },
  "related_tags": [{ "text": "love", "slug": "love" }],
  "search_degraded": false
}

البدء السريع

1احصل على مفتاحسجّل الدخول وأنشئ مفتاحًا أدناه. احتفظ به على الخادم؛ لا مكان له أبدًا في كود المتصفح.

export ICONHUB_KEY="ih_live_…"

2ابحثاعثر على الأيقونات بالكلمة المفتاحية والنوع والشكل واللون والنمط. اطلب svg عبر with= للحصول على الكود مضمّنًا.

GET /icons?search=weather&type=Sticker&with=styles

3اعرضضمّن svg_code المُنقّى مباشرة، أو استخدم static_image_url لمعاينة AVIF جاهزة.

<img src="https://storage.iconhub.com/icons/sun-….avif" width="24" alt="Sun">

نقاط النهاية

عنوان URL الأساسي https://admin.iconhub.com/api/v1 · أرسل رمزك عبر Authorization: Bearer … مع Accept: application/json. تُعيد القوائم data + pagination؛ وتُعيد استدعاءات التفاصيل { status, message, data }. مفاتيح الاستعلام غير المعروفة تُعيد 422.

المعاملات

searchstringبحث نصي كامل مرتّب حسب الصلة ومتسامح مع الأخطاء الإملائية

typeenumIcon, Sticker, InterfaceIcon, AnimatedIcon

colors[]name[]أسماء الألوان من ‎/colors، مثل Blue

shapes[]name[]Outline, Fill, Lineal Color, Hand Drawn

styles[]slug[]معرّفات الأنماط من ‎/styles

tagslugمعرّف الوسم

packslugالأيقونات الموجودة في هذه الحزمة فقط

sort_bystringname, created_at, downloads, views

page / per_pageintحجم الصفحة حتى 100

withstringsvg, styles, colors, tags, packs, variants, similars

GET https://admin.iconhub.com/api/v1/icons?search=heart&shapes[]=Outline&with=svg,styles&per_page=40

{ "data": [ { "slug": "heart", "name": "Heart", "svg": { "svg_code": "<svg …>" } } ],
  "pagination": { "current_page": 1, "last_page": 5867, "limit": 40, "total": 234649 },
  "related_tags": [ { "text": "love", "slug": "love" } ] }

مفاتيح API الخاصة بك

المفاتيح مرتبطة بحسابك. قيّد كل مفتاح بالنطاقات التي تستخدمه.

سجّل الدخول لإنشاء المفاتيحيمنحك الحساب المجاني حتى 10 مفاتيح، وقيودًا لكل نطاق، ولوحة لمتابعة الاستخدام.

انضم مجانًا تسجيل الدخول

إنشاء مفتاح

الاسم

النطاقات المسموح بها

مجاني، مع استخدام عادلالواجهة البرمجية لا تكلّف شيئًا. 300 طلب في الدقيقة لكل مفتاح. تواصل معنا إن احتجت المزيد.

الإسناداعرض عبارة «أيقونات من IconHub» مع رابط بالقرب من مكان ظهور الأيقونات في منتجك.

التخزين المؤقتتحمل الاستجابات ETag؛ أرسل If-None-Match لتحصل على 304. لا تنسخ المكتبة ولا تنزّلها بالجملة عبر الواجهة البرمجية.

واجهة IconHub البرمجية

البدء السريع

نقاط النهاية

مفاتيح API الخاصة بك

الاستخدام العادل