MediaWiki API عبارة عن مجموعة موثقة جيدًا من أدوات التطوير التي يمكنها القيام بمعظم المهام في نص برمجي واحد. تُستخدم واجهة برمجة التطبيقات عادةً لتطوير أدوات آلية لاستخدامها في الويكي. يمكن استخدام واجهة برمجة تطبيقات MediaWiki بسهولة من قبل معظم اللغات ، خاصة PHP (وظائف curl) بالإضافة إلى لغة Perl وعدد قليل من اللغات الأخرى..
خطوات
الخطوة الأولى. اقرأ وثائق MediaWiki API
إنه موجود في "api.php" في نفس الدليل مثل index.php المعتاد. مثال:
الخطوة 2. حدد تنسيق الإخراج
يوفر MediaWiki إخراج البيانات في شكل JSON و JSONFM و PHP (تنسيق تسلسلي) و PHPFM و WDDX و WDDXFM و XML و XMLFM و YAML و YAMLFM و RAWFM. التنسيقات الملحقة بـ "FM" مطبوعة بتنسيق HTML.
الخطوة 3. اختر إجراء
تدعم واجهة برمجة تطبيقات MediaWiki الإجراءات التالية:
- مساعدة - انظر شاشة التعليمات
- تسجيل الدخول - تسجيل الدخول إلى ميدياويكي
- opensearch - تطبيق بروتوكول openearch. (لا تحتوي كل منشآت ميدياويكي على هذا).
- feedwatchlist - إرجاع موجز قائمة المراقبة.
- الاستعلام - لديه مجموعة متنوعة من الخيارات. راجع وثائق MediaWiki API الخاصة بهم.
الخطوة 4. حدد استعلامًا أو قائمة
إلى جانب الإجراءات القياسية ، يدعم ميدياويكي الاستعلامات والقوائم المختلفة ، مثل سرد الصفحات التي تحتوي على رابط لمقال آخر ، وعدد التغييرات الأخيرة ، والمساهمات ، وما إلى ذلك.
الخطوة 5. قم بتمرير البيانات المنشورة إلى API من خلال استخدام CURL أو أداة أخرى تسمح لك باستخدام طريقة POST إلى البرنامج النصي
قد تعمل طريقة GET أيضًا.
الخطوة السادسة: تأكد من الاحتفاظ بملفات تعريف الارتباط المرسلة إلى أحد التطبيقات (قد ترغب بعض البرامج النصية / التطبيقات في تخزينها في مجلد فرعي
الخطوة 7. عند التفاعل مع واجهة مستخدم ميدياويكي ، ضع في اعتبارك أن رمز التحرير الخاص بك محفوظ في معظم صفحات التحرير
يتم استخدام رمز التحرير لتحديد تضاربات التحرير وتجنب تجاوز تحرير آخر تم بالفعل (يتم استخدام هذا في التراجع أيضًا.). ضع في اعتبارك أنه من الأسهل أن تنحرف الأمور عن مسارها إذا كنت تتعامل مع واجهة مستخدم الويكي. ضع في اعتبارك أي رموز تعبيرية تستخدمها للتأكد من أنها ستؤدي فقط إلى النتيجة المرجوة.
الخطوة الثامنة. اقرأ النتائج المرسلة من الويكي
سيتم إرسال النتائج إليك في استجابة HTTP ، والتي يمكن قراءتها من قبل العديد من المحللين. اعتني بالصيغة التي تختارها. تأكد من استخدام المحلل اللغوي المناسب لهذا التنسيق. عادة ما يكون من الممارسات الجيدة ذكر التنسيق صراحة لميدياويكي حتى لو كان له تنسيق افتراضي تريد استخدامه.
نصائح
- تأكد من حصولك على دعم الويكي المحلي الخاص بك للنص قبل استخدام API.
- يمكنك العثور على المزيد حول ميدياويكي باستخدام واجهة برمجة التطبيقات الخاصة به.