واجهة برمجة التطبيقات:Tokens (action)
Appearance
هذه الصفحة جزء من توثيق واجهة برمجة تطبيقات ميدياويكي التي تحمل اسم Action. |
tokens | ||
---|---|---|
Gets tokens for data-modifying actions. لا يمكن استخدام هذه الوحدة البرمجية بصفة مولّد. | ||
بادئة | ||
حقوق مطلوبة | لا شيء | |
النشر فقط؟ | لا | |
مساعدة مولّدة | الحالي | |
النسخة التي أضيفت فيها |
|
من أجل الطريقة الحالية للحصول على الرموز من خلال وحدة 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».