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

tokens
Gets tokens for data-modifying actions. لا يمكن استخدام هذه الوحدة البرمجية بصفة مولّد.
بادئة
حقوق مطلوبة	لا شيء
النشر فقط؟	لا
مساعدة مولّدة	الحالي
النسخة التي أضيفت فيها	≥ 1.20

من أجل الطريقة الحالية للحصول على الرموز من خلال وحدة 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)

api.php?action=tokens [جربها في ApiSandbox]

النتيجة
<?xml version="1.0"?> <api> <tokens edittoken="6c82e3a4f17f52ff1e2e4a16b64fed10+\" /> </api>

Getting several tokens at once

api.php?action=tokens&type=edit|email|patrol|watch [جربها في ApiSandbox]

النتيجة
<?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».