Jump to content

واجهة برمجة التطبيقات:Tokens (action)

From mediawiki.org
This page is a translated version of the page API:Tokens (action) and the translation is 100% complete.
من أجل الطريقة الحالية للحصول على الرموز من خلال وحدة meta، اذهب إلى: API:Tokens.
تم إهمال action=tokens في MW 1.24 وإزالته في 1.37. استخدم action=query&meta=tokens بدلاً منه. (See واجهة برمجة التطبيقات:Tokens .)

يمكن الحصول على الرموز مستخدمًا action=tokens. يمكن بعد ذلك استخدام هذه الرموز في طلبات واجهة برمجة التطبيقات الأخرى.

المعاملات

  • type: نوع الرمز المطلوب.
    • block
    • delete
    • edit
    • email
    • import
    • move
    • options
    • patrol
    • protect
    • rollback
    • unblock
    • watch

      امتداد التصريح المركزي على خوادم ميدياويكي يضيف الرموز التالية:
    • deleteglobalaccount
    • setglobalaccountstatus

أمثلة

Getting an edit token (default behavior)
النتيجة
<?xml version="1.0"?>
<api>
  <tokens edittoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" />
</api>
Getting several tokens at once
النتيجة
<?xml version="1.0"?>
<api>
  <tokens edittoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" emailtoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" patroltoken="0eaa2666f8c6c0779c43acbdf9703c4a+\" watchtoken="22dff2c0b0c1bef9ad34673b81b91f22+\" />
</api>

الأخطاء المحتملة

خلاف الأخطاء المعتادة، يمكن أن ترجع أخطاء أخرى في الصيغة التالية:

<?xml version="1.0"?>
<api>
   <warnings>
      <tokens>قيمة غير معروفة للوسيط <var>type</var>: test.</tokens>
   </warnings>
   <tokens/>
</api>

تشتمل الأخطاء المحتملة على ما يلي:

  • قيمة غير معروفة للوسيط type: value.
  • ⧼apiwarn-tokennotallowed⧽

عدم urlencode الرمز قد ينتج عنه في حدوث خطأ رمز غير ساري.

ملاحظة هامة

يجب عليك أن ترسل ملف تعريف الارتباط المتحصل عليه من مرحلة تسجيل الدخول حينما تستدعي واجهة برمجة التطبيقات مستخدمًا تصرف «الرموز» وإلا سوف تحصل على رسالة الخطأ الغامضة «readapidenied».

توثيق واجهة برمجة التطبيقات

Module "tokens" not found.