עזרה של MediaWiki API
זהו דף תיעוד של API שנוצר באופן אוטומטי.
תיעוד ודוגמאות: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
command=createentry
- המודול הזה פנימי או בלתי־יציב, ולא כדאי לך להשתמש בו. הפעולה שלו יכולה להשתנות ללא הודעה מוקדמת.
- יחידה זו דורשת הרשאות קריאה.
- היחידה הזאת דורשת הרשאות כתיבה.
- יחידה זו מקבלת רק בקשות POST.
- מקור: ReadingLists
- רישיון: GPL-2.0-or-later
הוספת דף חדש לרשימה ששייכת למשתמש הנוכחי.
ערכי רשימה חייבים להיות ייחודיים. הדפים אינם מוגבלים לאתר הוויקי שממנו מתבצעת הגישה ל־API. למשתמש צריכים להיות פחות מ־5000 ערכים (שלא נמחקו) ברשימה.
- list
מזהה הרשימה.
- הפרמטר הזה נדרש.
- סוג: מספר שלם
- project
שם המיזם של אתר הוויקי שבו נמצא הדף. (בדרך־כלל זהו שם התחום של אתר הוויקי.) נדרש אלא אם נעשית יצירה באצווה.
- לא יכול להיות ארוך מ־255 בתים.
- title
כותרת הדף (כולל השם המתורגם של מרחב השם). נדרש אלא אם נעשה שימוש ביצירת אצווה. מומלץ להשתמש בפורמט שמתאים לקריאה על־ידי אדם (רווחים ולא קווים תחתיים). ה־API מתייחס לכותרות בתור מחרוזות גולמיות; פעולת הנרמול (למשל, התייחסות מתאימה לאותיות רישיות או קטנות בכותרות) מושארת ללקוחות.
- לא יכול להיות ארוך מ־383 בתים.
- batch
נתוני אצווה ליצירת ערכי רשימות מרובים (באותה הרשימה) בבקשה אחת, בתחביר של מערך JSON עם אחד או יותר מהאובייקטים עם השדות project ו־title.
- הוספת הדף Dog מהמיזם en.wikipedia.org לרשימה עם המזהה 33.
- api.php?action=readinglists&command=createentry&list=33&project=https%3A%2F%2Fen.wikipedia.org&title=Dog&token=123ABC [פתיחה בארגז חול]
- הוספת דפים מרובים לרשימה.
- api.php?action=readinglists&command=createentry&list=33&batch=%5B%7B%22project%22%3A%22https%3A%5C%2F%5C%2Fen.wikipedia.org%22%2C%22title%22%3A%22Dog%22%7D%2C%7B%22project%22%3A%22https%3A%5C%2F%5C%2Fen.wikipedia.org%22%2C%22title%22%3A%22Cat%22%7D%5D&token=123ABC [פתיחה בארגז חול]