توثيق واجهة برمجة التطبيقات
واجهة برمجة تطبيقات رموز يونيكود مجانية. لا يلزم مصادقة. استجابات JSON.
الرابط الأساسي
https://symbolfyi.com/api/
GET
تفاصيل الرمز
احصل على معلومات كاملة حول رمز ما، بما في ذلك خصائص يونيكود وجميع تمثيلات الترميز.
/api/symbol/{slug}/
المعاملات
| slug | معرّف الرمز (مثال: black-heart-suit) |
مثال
curl https://symbolfyi.com/api/symbol/black-heart-suit/
{
"character": "♥",
"name": "Black Heart Suit",
"codepoint": "U+2665",
"slug": "black-heart-suit",
"category": "Card Suits",
"block": "Miscellaneous Symbols",
"script": "Common",
"general_category": "So",
"keywords": "heart, love, card, suit",
"encodings": {
"unicode": "U+2665",
"html_decimal": "♥",
"html_hex": "♥",
"html_entity": "♥",
"css": "\\2665",
"javascript": "\\u2665",
"python": "\\u2665",
"java": "\\u2665",
"utf8_bytes": "E2 99 A5",
"utf16_bytes": "26 65",
"url_encoded": "%E2%99%A5"
},
"url": "/symbol/black-heart-suit/"
}
GET
ابحث عن الرموز
ابحث عن الرموز بالاسم أو الكلمة المفتاحية أو الاسم المستعار أو كيان HTML. يقبل أيضًا حرفًا واحدًا للبحث الدقيق.
/api/search/?q={query}
المعاملات
| q | استعلام البحث (اسم أو كلمة مفتاحية أو حرف) |
مثال
curl "https://symbolfyi.com/api/search/?q=arrow"
{
"results": [
{"character": "→", "name": "Rightwards Arrow", "slug": "rightwards-arrow", "codepoint": "U+2192", "category": "Arrows", "url": "/symbol/rightwards-arrow/"},
{"character": "←", "name": "Leftwards Arrow", "slug": "leftwards-arrow", "codepoint": "U+2190", "category": "Arrows", "url": "/symbol/leftwards-arrow/"},
{"character": "↑", "name": "Upwards Arrow", "slug": "upwards-arrow", "codepoint": "U+2191", "category": "Arrows", "url": "/symbol/upwards-arrow/"}
]
}
GET
رموز الفئة
احصل على جميع الرموز في فئة ما (بحد أقصى 200).
/api/category/{slug}/
المعاملات
| slug | معرّف الفئة (مثال: arrows أو currency أو mathematical) |
مثال
curl https://symbolfyi.com/api/category/currency/
{
"category": {"name": "Currency", "slug": "currency", "icon": "$"},
"symbols": [
{"character": "$", "name": "Dollar Sign", "slug": "dollar-sign", "codepoint": "U+0024", "url": "/symbol/dollar-sign/"},
{"character": "€", "name": "Euro Sign", "slug": "euro-sign", "codepoint": "U+20AC", "url": "/symbol/euro-sign/"},
{"character": "£", "name": "Pound Sign", "slug": "pound-sign", "codepoint": "U+00A3", "url": "/symbol/pound-sign/"}
]
}
GET
ترميز الحرف
احصل على معلومات يونيكود وجميع تمثيلات الترميز لأي حرف. يعمل مع أي حرف يونيكود، وليس فقط الرموز المنتقاة.
/api/encode/?char={character}
المعاملات
| char | أي حرف يونيكود (يُستخدم الحرف الأول في حالة إدخال أكثر من حرف) |
مثال
curl "https://symbolfyi.com/api/encode/?char=★"
{
"character": "★",
"name": "BLACK STAR",
"codepoint": "U+2605",
"category": "So",
"category_name": "Symbol, other",
"block": "Miscellaneous Symbols",
"script": "Common",
"encodings": {
"unicode": "U+2605",
"html_decimal": "★",
"html_hex": "★",
"html_entity": "",
"css": "\\2605",
"javascript": "\\u2605",
"python": "\\u2605",
"java": "\\u2605",
"utf8_bytes": "E2 98 85",
"utf16_bytes": "26 05",
"url_encoded": "%E2%98%85"
}
}
ملاحظات الاستخدام
- ✓ مجاني الاستخدام لأي غرض
- ✓ لا يلزم مفتاح API أو مصادقة
- ✓ CORS مفعّل لطلبات المتصفح
- ✓ مواصفة OpenAPI 3.1 متاحة على /api/openapi.json
- ⚠ يُرجى التعقل في معدلات الطلبات