مساعدة API ميدياويكي

هذه صفحة توثيق ميدياويكي API التي تم إنشاؤها تلقائيا.

وثائق وأمثلة: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=wbsetreference

(main | wbsetreference)

هذه الوحدة تتطلب صلاحيات القراءة.
هذه الوحدة تتطلب صلاحيات الكتابة.
هذه الوحدة تقبل طلبات POST فقط.
المصدر:WikibaseClient
الترخيص: GPL-2.0-or-later

ينشيء مرجع أو يحدد قيمة مرجع موجود.

معلمات محددة:

المعلمات العامة الأخرى متاحة.

statement: GUID لتعريف البيان الذي يتم ضبط مرجع له; هذه المعلمة مطلوبة.
snaks: السناك لضبط المرجع له. كائن JSON مع أرقام خاصية تشير إلى المصفوفات المحتوية على السناك لتلك الخاصية; هذه المعلمة مطلوبة.
snaks-order: ترتيب السناك. مصفوفة JSON لحروف أرقام الخواص
reference: هاش المرجع الذي ينبغي أن يتم تحديثه. اختياري. عند عدم توفيره، يتم إنشاء مرجع جديد
index: الفهرس من بين قائمة مراجع البيان حيث ليتم نقل المرجع. اختياري. عند عدم توفيره، فسيبقى في مكانه مرجع موجود في حين ستتم إضافة مرجع جديد.; النوع: 2 = قائمة الأعداد الصحيحة
summary: ملخص التعديل. ستتم إضافته بعد تعليق مولد تلقائيا. حد الطول للتعليق التلقائي مع الملخص هو 260 حرف. انتبه إلى أن كل شيء فوق هذا الحد ستتم إزالته.
tags: وسوم التغيير لتطبيقها على المراجعة.; القيم (منفصلة مع | أو البديل):
token: تم استرداد رمز مميز "csrf" من action=query&meta=tokens; هذه المعلمة مطلوبة.
baserevid: المعرف الرقمي للمراجعة لنسب التعديل عليها. هذا يستخدم لكشف التعارضات أثناء الحفظ.; النوع: 2 = قائمة الأعداد الصحيحة
bot: علم على هذا التعديل كبوت. علم المسار هذا سيتم احترامه فقط إذا ما كان المستخدم ينتمي للمجموعة "bot".; النوع: منطقي (التفاصيل)
returnto: عنوان الصفحة. إذا أدى حفظ التعديل إلى إنشاء حساب مؤقت، فقد تستجيب واجهة برمجة التطبيقات (API) برابط URL يجب على العميل زيارته لإكمال تسجيل الدخول. عند توفير هذه المعلمة، سيتم إعادة توجيه الرابط إلى الصفحة المحددة، بدلاً من الصفحة التي تم تعديلها.; النوع: عنوان صفحة; يقبل الصفحات غير الموجودة.
returntoquery: معلمات استعلام عنوان URL (بعلامة "؟" ). إذا أدى حفظ التعديل إلى إنشاء حساب مؤقت، فقد تستجيب واجهة برمجة التطبيقات (API) بعنوان URL يجب على العميل زيارته لإكمال تسجيل الدخول. عند توفير هذه المعلمة، سيتم إعادة توجيه عنوان URL إلى صفحة تحتوي على معلمات الاستعلام المحددة.; الافتراضي: (فارغ)
returntoanchor: شظية عنوان URL (بعلامة # في البداية). إذا أدى حفظ التعديل إلى إنشاء حساب مؤقت، فقد تستجيب واجهة برمجة التطبيقات (API) برابط URL يجب على العميل زيارته لإكمال تسجيل الدخول. عند توفير هذه المعلمة، سيتم إعادة توجيه عنوان URL إلى صفحة تحتوي على الشظية المحددة.; الافتراضي: (فارغ)

أمثلة:

أنشىء مرجعا جديدا ب GUID Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF: api.php?action=wbsetreference&statement=Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF&snaks={"P212":[{"snaktype":"value","property":"P212","datavalue":{"type":"string","value":"foo"}}]}&baserevid=7201010&token=foobar [فتح في ملعب]
اضبط المرجع للادعاء ب GUID Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF والذي له هاش 1eb8793c002b1d9820c833d234a1b54c8e94187e: api.php?action=wbsetreference&statement=Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF&reference=1eb8793c002b1d9820c833d234a1b54c8e94187e&snaks={"P212":[{"snaktype":"value","property":"P212","datavalue":{"type":"string","value":"bar"}}]}&baserevid=7201010&token=foobar [فتح في ملعب]
ينشيء مرجعا جديدا للادعاء ب GUID Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF ويدرج المرجع الجديد أعلى قائمة المراجع بدلا من إضافته في الأسفل.: api.php?action=wbsetreference&statement=Q999999998$D4FDE516-F20C-4154-ADCE-7C5B609DFDFF&snaks={"P212":[{"snaktype":"novalue","property":"P212"}]}&index=0&baserevid=7201010&token=foobar [فتح في ملعب]