راهنمای واسط برنامه‌نویسی کاربردی مدیاویکی

این یک صفحهٔ مستندات برای واسط برنامه‌نویسی کاربردی مدیاویکی است که به‌طور خودکار ایجاد شده‌است.

مستندات و نمونه‌ها: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=wbeditentity

(main | wbeditentity)
  • این پودمان نیازمند اختیارات خواندن است.
  • این پودمان نیازمند اختیارات خواندن است.
  • این پودمان تنها درخواست‌های POST را می‌پذیرد.
  • منبع: WikibaseClient
  • مجوز: GPL-2.0-or-later

Creates a single new Wikibase entity and modifies it with serialised information.

پارامترها:
id

شناسۀ جوهره شامل پیشوند. یا از id یا از site و title با هم استفاده کنید.

new

اگر قرار داده شود، یک جوهره جدید ساخته خواهدشد. این را نوع ورودی‌ای قرار دهید که قصد دارید ایجادش کنید. مجاز نیستید هنگامی که شناسه وجود دارد، این را قرار بدهید.

یکی از مقدارهای زیر: item، property
site

شناسۀ وبگاهی که صفحه در آن وجود دارد. به همراه title استفاده کنید تا تشکیل یک پیونداد کامل دهد.

یکی از مقدارهای زیر:
title

عنوان صفحه که با آن مطابقت دارد. همراه با site استفاده کنید تا تشکیل یک پیونداد کامل دهد.

baserevid

شناسۀ عددی برای بازبینی برای مبنا قرار دادن برای تغییرات. این برای شناسایی تداخل‌ها در زمان ذخیره‌سازی استفاده می‌شود.

نوع: عدد صحیح
summary

خلاصه ویرایش. یک نظر خود به خودی ایجاد می‌شود. محدودیت طول آن، ۲۶۰ نویسه است. دقت کنید که بیشتر از آن نشان داده نمی‌شود.

tags

Change tags to apply to the revision.

مقدارهای (جداشده با | یا جایگزین‌های آن):
token

یک بلیط «csrf» واکشی‌شده از action=query&meta=tokens

این پارامتر الزامی است.
bot

این ویرایش را به عنوان ربات علامتگذاری کن. فلگ یوآرال تنها در صورتی قابل اعتنا است که کاربر موردنظر عضو گروه "ربات‌ها" باشد.

نوع: بولی (جزئیات)
data

شی پشت سر همی که به عنوان منبع داده استفاده شده است. یک جوهره که به تازگی ایجاد شده است با یک شناسه مشخص خواهد شد.

این پارامتر الزامی است.
clear

اگر قرار داده شود قبل از جلو رفتن کل جوهره خالی می‌شود. پیش از آنکه "data" کامل پر شوند، امکان ذخیزه جوهره وجود نخواهد داشت.

نوع: بولی (جزئیات)
نمونه‌ها:
ایجاد یک آیتم خالی، بازگرداندن ساختار کلی ورودی
api.php?action=wbeditentity&new=item&data={} [باز کردن در صفحهٔ تمرین]
ساخت یک آیتم و برچسب برای de و en
api.php?action=wbeditentity&new=item&data={"labels":{"de":{"language":"de","value":"de-value"},"en":{"language":"en","value":"en-value"}}} [باز کردن در صفحهٔ تمرین]
یک ویژگی جدید ایجاد کنید که حاوی داده‌های جیسون باشد و ساختار جوهره را تماما نشان دهد
api.php?action=wbeditentity&new=property&data={"labels":{"en-gb":{"language":"en-gb","value":"Propertylabel"}},"descriptions":{"en-gb":{"language":"en-gb","value":"Propertydescription"}},"datatype":"string"} [باز کردن در صفحهٔ تمرین]
پاک‌کردن همهٔ داده‌ها از هستار با شناسهٔ Q42
api.php?action=wbeditentity&clear=true&id=Q999999998&data={} [باز کردن در صفحهٔ تمرین]
همه داده‌ها را از جوهره‌ای به شناسه Q42 پاک کن و یک برچسب en برای آن قرار بده.
api.php?action=wbeditentity&clear=true&id=Q999999998&data={"labels":{"en":{"language":"en","value":"en-value"}}} [باز کردن در صفحهٔ تمرین]
یک برچسب می‌افزاید بدون اینکه روی برچسب‌های قبلی تغییری ایجاد کند.
api.php?action=wbeditentity&id=Q999999998&data={"labels":[{"language":"no","value":"Bar","add":""}]} [باز کردن در صفحهٔ تمرین]
یک برچسب را حذف می‌کند
api.php?action=wbeditentity&id=Q999999998&data={"labels":[{"language":"en","value":"Foo","remove":""}]} [باز کردن در صفحهٔ تمرین]
پیوندادی برای ویکی قرار می‌دهد و در صورتی که قبلا یکی وجود داشته باشد دوباره روی آن می‌نویسد
api.php?action=wbeditentity&id=Q999999998&data={"sitelinks":{"nowiki":{"site":"nowiki","title":"København"}}} [باز کردن در صفحهٔ تمرین]
توضیحاتی برای nb قرار می‌دهد و در صورتی که قبلا یکی وجود داشته باشد دوباره روی آن می‌نویسد
api.php?action=wbeditentity&id=Q999999998&data={"descriptions":{"nb":{"language":"nb","value":"nb-Description-Here"}}} [باز کردن در صفحهٔ تمرین]
یک اظهارنظر جدید برای آیتمی ایجاد می‌کند که ویژگی P56 و مقدار «مثال رشته‌ای» دارد.
api.php?action=wbeditentity&id=Q999999998&data={"claims":[{"mainsnak":{"snaktype":"value","property":"P56","datavalue":{"value":"ExampleString","type":"string"}},"type":"statement","rank":"normal"}]} [باز کردن در صفحهٔ تمرین]
حذف ادعا از آیتم توسط GUID Q42$D8404CDA-25E4-4334-AF13-A3290BCD9C0F و Q42$GH678DSA-01PQ-28XC-HJ90-DDFD9990126X
api.php?action=wbeditentity&id=Q999999998&data={"claims":[{"id":"Q999999998$D8404CDA-25E4-4334-AF13-A3290BCD9C0F","remove":""},{"id":"Q999999998$GH678DSA-01PQ-28XC-HJ90-DDFD9990126X","remove":""}]} [باز کردن در صفحهٔ تمرین]
اظهار نظری را که دارای شناسه GU (جی یو آی دی) است به مقدار اظهار نظر بر می گرداند
api.php?action=wbeditentity&id=Q999999998&data={"claims":[{"id":"Q999999998$GH678DSA-01PQ-28XC-HJ90-DDFD9990126X","mainsnak":{"snaktype":"value","property":"P56","datavalue":{"value":"ChangedString","type":"string"}},"type":"statement","rank":"normal"}]} [باز کردن در صفحهٔ تمرین]