واجهة EmojiSelect API

النقاط النهائية

المرجع الكامل للنقاط النهائية وأمثلة تفاعلية: /api/docs، أو خذ مواصفة OpenAPI 3.0 واستوردها إلى Postman أو Insomnia.

حدود الاستخدام

الطبقة المجانية تسمح بـ1,000 طلب يوميًا لكل عنوان IP (بيوم UTC). كل استجابة تحمل ترويسات X-RateLimit-Limit وX-RateLimit-Remaining وX-RateLimit-Reset؛ وعند بلوغ الحد تجيب الواجهة بـ429 مع خطأ rate_limit_exceeded.

أمثلة برمجية

إيموجي واحد — كل التفاصيل

curl https://emojiselect.com/api/v1/emoji/red-heart

البحث (حتمي، بنفس ترتيب بحث الموقع)

curl 'https://emojiselect.com/api/v1/search?q=heart&locale=en&limit=5'

جافاسكريبت (fetch)

const res = await fetch(
  "https://emojiselect.com/api/v1/search?q=heart&limit=5"
);
const data = await res.json();
console.log(data.results.map((r) => r.char + " " + r.name));

بايثون (requests)

import requests

r = requests.get(
    "https://emojiselect.com/api/v1/emoji/red-heart",
    timeout=10,
)
print(r.json()["char"], r.json()["names"]["ar"])

ما لا تفعله الواجهة: لا تولّد محتوى، ولا تخمّن النوايا بالذكاء الاصطناعي، ولا تختلق إحصاءات. تعيد بيانات الكتالوج كما هي. المعاني تظهر فقط للغات المحرَّرة تحريريًا: 984 إيموجي بـ16 لغة (de, es, fr, hi, id, it, ja, ko, nl, pl, pt-BR, ru, th, tr, vi, zh-CN) إضافة إلى التشيكية (cs، 984) وقاعدة en/ar التحريرية — أما بقية اللغات فتحمل الأسماء فقط.