صورة الغلاف بواسطة كريستوفر جاور على Unsplash

هل تقوم بتطوير تطبيق لتعلم اللغة، أو مساعد كتابة، أو أي مشروع يتضمن كلمات وتحتاج إلى واجهة برمجة تطبيقات لاستعادة معاني الكلمات؟ توفر Free Dictionary API طريقة مجانية ويمكن الوصول إليها لدمج بيانات اللغة في عملك. ستوضح لك هذه الوثائق كيفية البدء.

في وثائق واجهة برمجة التطبيقات هذه:

• حول واجهة برمجة تطبيقات القاموس المجاني
• نقطة النهاية
• أمثلة
• موارد إضافية

حول واجهة برمجة تطبيقات القاموس المجاني:

تم تطوير واجهة برمجة تطبيقات القاموس المجانية بواسطة MeetDeveloper ولديها 2.6 ألف نجمة على GitHub. تدعم واجهة برمجة التطبيقات (API) طلبات GET فقط وتوفر تعريفات للكلمات بالإضافة إلى النسخ الصوتي.

الميزات الرئيسية:

• مجاني للاستخدام
• لا حدود للاستخدام
• لا يلزم الحصول على إذن أو مفاتيح API

نقطة النهاية

https://api.dictionaryapi.dev/api/v2/entries/en/

• تقوم نقطة النهاية هذه باسترداد معلومات القاموس للكلمة الإنجليزية المحددة.

• تحتوي واجهة برمجة التطبيقات (API) على نسختين: v1 وv2. الفرق الأساسي يكمن في بنية الاستجابة. الإصدار الحالي هو v2.

معلمات الاستعلام

• word (سلسلة، مطلوبة): الكلمة التي تريد البحث عنها.

تنسيق الاستجابة

ترجع واجهة برمجة التطبيقات مصفوفة JSON تحتوي على كائن واحد يحتوي على معلومات مفصلة حول الكلمة، بما في ذلك:

إذا نجح الطلب:

• كلمة (سلسلة): الكلمة المستعلم عنها
• الصوتية (سلسلة): النسخ الصوتي للكلمة
• الصوتيات (صفيف): مجموعة من الكائنات الصوتية، لكل منها:
• النص (سلسلة): النسخ الصوتي
• audio(سلسلة): عنوان URL للنطق الصوتي (قد يكون فارغًا)
• المعاني (صفيف): مجموعة من الكائنات التي تمثل المعاني
• PartOfSpeech (سلسلة): جزء الكلام (على سبيل المثال، اسم، فعل)
• التعريفات (صفيف): مجموعة من كائنات التعريف، كل منها يحتوي على:
• التعريف (السلسلة): تعريف الكلمة
• المرادفات (صفيف): مجموعة من المرادفات
• المتضادات (صفيف): مجموعة من المتضادات
• الترخيص (الكائن): معلومات حول الترخيص الذي يتم بموجبه تقديم البيانات
• sourceUrls (صفيف): مجموعة من عناوين URL لمصادر البيانات

إذا لم ينجح الطلب:

• العنوان (سلسلة): رسالة تشير إلى عدم العثور على تعريفات لكلمة
• الرسالة (سلسلة): رسالة تفيد بعدم العثور على تعريفات للكلمة
• الدقة (سلسلة): اقتراح لاستخدام البحث مرة أخرى أو الويب.

أمثلة:

نموذج الطلب 1 (ناجح):

const word = "documentation";
fetch(`https://api.dictionaryapi.dev/api/v2/entries/en/${word}`)
  .then(response => response.json())
  .then(data => console.log(data));

مثال للإجابة 1:

[
  {
    "word": "documentation",
    "phonetic": "/ˌdɒkjʊmənˈteɪʃən/",
    "phonetics": [
      {
        "text": "/ˌdɒkjʊmənˈteɪʃən/",
        "audio": ""
      },
      {
        "text": "/ˌdɑkjəmənˈteɪʃən/",
        "audio": ""
      }
    ],
    "meanings": [
      {
        "partOfSpeech": "noun",
        "definitions": [
          {
            "definition": "Something transposed from a thought to a document; the written account of an idea.",
            "synonyms": [],
            "antonyms": []
          },
          {
            "definition": "Documentary evidence and sources.",
            "synonyms": [],
            "antonyms": []
          },
          {
            "definition": "Documents that explain the operation of a particular machine or software program.",
            "synonyms": [],
            "antonyms": []
          },
          {
            "definition": "Comments that explain the usage of individual functions, libraries and blocks of code.",
            "synonyms": [],
            "antonyms": []
          }
        ],
        "synonyms": [],
        "antonyms": []
      }
    ],
    "license": {
      "name": "CC BY-SA 3.0",
      "url": "https://creativecommons.org/licenses/by-sa/3.0"
    },
    "sourceUrls": [
      "https://en.wiktionary.org/wiki/documentation"
    ]
  }
]

طلب مثال 2 :

const word = "Software engineer";
fetch(`https://api.dictionaryapi.dev/api/v2/entries/en/${word}`)
  .then(response => response.json())
  .then(data => console.log(data));

مثال الرد 2 (غير ناجح):

{
  "title": "No Definitions Found",
  "message": "Sorry pal, we couldn't find definitions for the word you were looking for.",
  "resolution": "You can try the search again at later time or head to the web instead."
}

رموز النجاح والخطأ

لا تعرض واجهة برمجة التطبيقات هذه حاليًا رموز نجاح أو خطأ محددة.

موارد إضافية

لتجربة واجهة برمجة التطبيقات (API) أو دعم Free Dictionary API، انتقل إلى موقع Free Dictionary API الإلكتروني.

راجع أيضًا مشروع Free Dictionary API على Github.