עזרה של MediaWiki API
××× ××£ ת××¢×× ×©× API ×©× ×צר ××××¤× ×××××××.
ת××¢×× ×××××××ת: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
××××× ×¨×ש×ת
- ×ק×ר: MediaWiki
- ר×ש×××: GPL-2.0-or-later
×צ×: ×Ö¾API ×©× ××××Ö¾×××§× ××× ××שק ×ת×ק ××צ×× ×©× ×ª×× ××שתפר ××××¤× ×¡××ר. ××£ ש×× ×× × ×שת×××× ××××× ×¢ ×××, ××¢×ת×× ×¢××× × ××צע ש×× ×××× ×©×¢××××× ×ש×ש ××ר×× ×פ×× ×§×¦××× ×××ת ×××ת; ××פשר××ª× ×עש×ת ××× ×× ×רש××ת ×תפ××¦× mediawiki-api-announce ××× ×ק×× ××××¢×ת ×¢× ×¢×××× ××.
×קש×ת ש××××ת: ×ש×קש×ת ש××××ת × ×©×××ת ×Ö¾API, ××ש×× ××תר HTTP ×¢× ×××¤×ª× "MediaWiki-API-Error", ××× ×× ××¢×¨× ×©× ×××תרת ××× ×§×× ×ש×××× ×××××¨× ××××ª× ×¢×¨×. ×××××¢ × ×סף, ×פשר ××¢××× ×××£ API:ש××××ת ××××ר×ת.
×××ק×: ×××××§× ×§×× ××תר ×©× ×קש×ת, ×פשר ××שת×ש ××ר×× ×××× ×©× API.
- action
×××× ×¤×¢××× ××צע.
- abusefiltercheckmatch
- ××××§× ××× ××¡× × ×ש×ת×ת ×ת××× ×ער×ת ××©×ª× ××, ×ער××× ×× ×פע××× ×©× ×¨×©×× ××××× ××ש×ת×ת.
- abusefilterchecksyntax
- ×××קת ת×××ר ×©× ××× ×××¡× × × ××ש×ת×ת.
- abusefilterevalexpression
- ×ער×ת ××××× ××¡× × ×ש×ת×ת.
- abusefilterunblockautopromote
- ×ס×ר ××שת×ש ×ת ××ס××× ××¤× × ×§××ת ק×××× ××××××× ×ת×צ×× ×פע××ת ××¡× × ×ש×ת×ת.
- abuselogprivatedetails
- צפ××× ×××××¢ פר×× ×©× ×¨×©××ת ×××× ×ש×ת×.
- block
- ×ס××ת ×שת×ש.
- changeauthenticationdata
- ש×× ×× × ×ª×× × ××××ת ×¢××ר ××שת×ש ×× ××××.
- changecontentmodel
- ש×× ×× ×××× ×ת××× ×©× ××£
- checktoken
- ×××קת ×תק×× ×ת ×©× ××ס×××× ×Ö¾action=query&meta=tokens.
- clearhasmsg
- ×× ×§× ×ת ×××
hasmsg×¢××ר ××שת×ש ×× ××××. - clientlogin
- ×× ××¡× ×××××§× ×××צע×ת ×ר××× ××××××ת.
- compare
- ק××ת ××××× ××× ×©× × ×פ××.
- createaccount
- ×צ×רת ×ש××× ×שת×ש ××ש.
- delete
- ×××קת ××£.
- edit
- ×צ××¨× ×ער××× ×©× ×פ××.
- emailuser
- ש×××ת ×××"× ××שת×ש.
- expandtemplates
- ×ר××× ×ת ×× ×ת×× ××ת ×ת×× ×§×× ××××ק×.
- feedcontributions
- ××××ר ××× ×ª תר×××ת ×שת×ש.
- feedrecentchanges
- ××××ר ××× ×ª ש×× ×××× ××ר×× ××.
- feedwatchlist
- ××××ר ××× ×ª רש××ת ×עק×.
- filerevert
- ש×××ר ק×××¥ ×××¨×¡× ××©× × ××תר.
- help
- ×צ×ת ×¢××¨× ×¢××ר ××××××ת שצ××× ×.
- imagerotate
- ס×××× ×©× ×ª××× × ××ת ×× ××תר.
- import
- ×××× ××£ ×××××§× ××ר ×× ×ק×××¥ XML.
- linkaccount
- ק×ש×ר ×ש××× ×©× ×¡×¤×§ צ×־ש×××©× ××שת×ש ×× ××××.
- login
- ×× ××¡× ×ק××ת ×¢××××ת ××××ת.
- logout
- ×צ××× ×× ×ק×× ×©× × ×ª×× × ××ת××ר×ת.
- managetags
- ××צ××¢ פע×××ת × ××××××ת ×קש×ר×ת ×ת×× ×©×× ××.
- mergehistory
- ××××× ×רס××ת ×©× ×פ××.
- move
- ××¢×רת ××£.
- opensearch
- ××פ×ש ×××××§× ×פר×××ק×× OpenSearch.
- options
- ש×× ×× ××¢×פ×ת ×©× ××שת×ש ×× ××××.
- paraminfo
- ק××ת ××××¢ ×¢× ×××××ת ×©× API.
- parse
- ××¤×¢× × ×ת ×ת××× ×××××ר פ×× ××¤×¢× ×.
- patrol
- ×× ×ר ××£ ×× ×רס×.
- protect
- ××©× ×ת ×ת ר×ת ×××× × ×©× ××£.
- purge
- × ×ק×× ×××××× ×××תר×ת ×©× ××ª× ×.
- query
- ××××ר × ×ª×× ×× ×××××Ö¾×××§× ××¢×××.
- removeauthenticationdata
- ×סרת × ×ª×× × ××××ת ×¢××ר ××שת×ש ×× ××××.
- resetpassword
- ש×××ת ×××"× ××פ×ס ס×ס×× ××שת×ש.
- revisiondelete
- ××××§× ×ש×××ר ×××××§× ×©× ×רס××ת.
- rollback
- ××××× ×ער××× ×××ר×× × ×××£.
- rsd
- ×צ×× ×¡××ת RSDâ (Really Simple Discovery).
- setnotificationtimestamp
- ×¢×××× ××ת×Ö¾×××× ×©× ×××××¢× ×¢××ר ×פ×× ××עק×.
- setpagelanguage
- ש×× ×× ××©×¤× ×©× ××£.
- spamblacklist
- ×××קת תק×× ×ת ×©× URL ××× ×× ××תר ×× ××× ×¨×©××ת ×ס××ת ×ספ××.
- tag
- ×××¡×¤× ×× ××¡×¨× ×©× ×ª××× ××רס××ת ×××××ת ×× ×¨×©×××ת ×××× ×××××ת.
- titleblacklist
- ×××קת תק×× ×ת ×©× ××תרת ××£, ×©× ×§×××¥, ×× ×©× ×שת×ש ×× ××× TitleBlacklist.
- unblock
- ש×ר×ר ×ס××ת ×שת×ש.
- undelete
- ש×××ר ×רס××ת ×©× ××£ ×××ק.
- unlinkaccount
- ××××× ×§×ש×ר ×©× ×ש××× ×¦×־ש×××©× ×××שת×ש ×× ××××.
- upload
- ××¢××ת ק×××¥, ×× ×§××ת ××¦× ×××¢×××ת ×××ת×× ×ת.
- userrights
- ש×× ×× ××ר×ת ×ק××צ×ת ×©× ××שת×ש.
- validatepassword
- ××××ק תק×× ×ת ס×ס×× ×× ××× ×××× ××ת ×ס×ס×××ת ×©× ××××ק×.
- watch
- ×××ס××£ ×פ×× ×רש××ת ×××¢×§× ×©× ××שת×ש ×× ×××× ×× ××¡×¨×ª× ××× ×.
- webapp-manifest
- ×××רת ××× ××¤×¡× ×©× ××ש×× ×רשת.
- cspreport
- ×¤× ×××. ×ש×ש ×פ××¤× ×× ×××××× ×פר×ת ×©× ×××× ××ת ××××ת ת×××. ×××××× ××× ××¢××× ×× ×ש×ש ××× ×× ××× ×ש×ש ×¢× ×פ××¤× ×ª××× CSP.
- stashedit
- ×¤× ×××. ××× ×ª ער××× ×××××× ×ש×תף.
- visualeditor
- ×¤× ×××. ×××רת HTML5 ×¢××ר ××£ ×ת×× ×©×ר×ת פרס××××.
- visualeditoredit
- ×¤× ×××. ש××רת ××£ HTML5 ×××××Ö¾×××§× (×××ר ×ק×× ×××§× ××¨× ×©×ר×ת פרס××××).
- ××× ××ער××× ×××××: abusefiltercheckmatch, abusefilterchecksyntax, abusefilterevalexpression, abusefilterunblockautopromote, abuselogprivatedetails, block, changeauthenticationdata, changecontentmodel, checktoken, clearhasmsg, clientlogin, compare, createaccount, delete, edit, emailuser, expandtemplates, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, help, imagerotate, import, linkaccount, login, logout, managetags, mergehistory, move, opensearch, options, paraminfo, parse, patrol, protect, purge, query, removeauthenticationdata, resetpassword, revisiondelete, rollback, rsd, setnotificationtimestamp, setpagelanguage, spamblacklist, tag, titleblacklist, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, webapp-manifest, cspreport, stashedit, visualeditor, visualeditoredit
- ×ר×רת ×××××: help
- format
תס××ר ×פ××.
- json
- ×פ××× × ×ª×× ×× ×תס××ר JSON.
- jsonfm
- ×פ××× × ×ª×× ×× ×תס××ר JSON (×¢× ×××¤×¡× ××¤× ×Ö¾HTML).
- none
- ×× ×פ××× ×©×× ××ר.
- php
- ×פ××× × ×ª×× ×× ×תס××ר PHP ××ס×ר.
- phpfm
- ×פ××× × ×ª×× ×× ×תס××ר PHP ××ס×ר (×¢× ×××¤×¡× ××¤× ×Ö¾HTML).
- rawfm
- ×פ××× ×ת ×× ×ª×× ××, ×××× ×××× ××× ×× ×פ×× ×©××××ת, ×תס××ר JSON (×¢× ×××¤×¡× ××¤× ×Ö¾HTML).
- xml
- ×פ××× × ×ª×× ×× ×תס××ר XML.
- xmlfm
- ×פ××× × ×ª×× ×× ×תס××ר XML (×¢× ×××¤×¡× ××¤× ×Ö¾HTML).
- ××× ××ער××× ×××××: json, jsonfm, none, php, phpfm, rawfm, xml, xmlfm
- ×ר×רת ×××××: jsonfm
- maxlag
ש×××× ×ר×× ×××× ×ש×ש ×ש××××Ö¾×××§× ×××ª×§× ×ª ××ש××× ×¢× ××¡× × ×ª×× ×× ×ש××פ×. ××× ××ס×× ×פע×××ת ש××ר××ת ××תר ש×××× ×ש×פ×× ×תר, ×פר××ר ××× ×××× ××ר×× ××ק×× ×××ת×× ×¢× ×©×©×××× ×ש×פ×× ×××¨× ×ת×ת ××¢×¨× ×©×¦×××. ×××§×¨× ×©× ×©×××× ×××××, ק×× ×ש×××× maxlag ××××ר ×¢× ××××¢× ××× Waiting for $host: $lag seconds lagged.
ר' ××ר×× ××שת×ש: פר××ר maxlag ×××××¢ × ×סף.- ס××: ×ספר ש××
- smaxage
×××××ר ×ת ××תר
s-maxage××קרת ××××× HTTPâ ××ספר ××× ×©× ×©× ××ת. ש××××ת ××£ ×¤×¢× ×× ××××× ×ת.- ס××: ×ספר ש××
- ×ר×רת ×××××: 0
- maxage
×××××ר ×ת ××תר
max-age××קרת ××××× HTTPâ ××ספר ××× ×©× ×©× ××ת. ש××××ת ××£ ×¤×¢× ×× ××××× ×ת.- ס××: ×ספר ש××
- ×ר×רת ×××××: 0
- assert
××××× ×©××שת×ש × ×× ×¡ ××ש××× ×× ×× ××××ר ×Ö¾user, ש×× × ×× ×¡ ××ש××× ×× ××××ר anon, ×× ×©×ש ×× ×רש×ת ××שת×ש "×××" ×× ×× bot.
- ××× ××ער××× ×××××: anon, bot, user
- assertuser
××××× ×©××שת×ש ×× ×××× ××× ××שת×ש שש×× × ×ת×.
- ס××: ×שת×ש, ×צ××¨× ××××: ×©× ×שת×ש
- requestid
×× ×¢×¨× ×©××× ×ª× ××× ××××× ×תש×××. ×פשר ××שת×ש ××× ××× ×××××× ××× ×קש×ת.
- servedby
××××× ×ת ×©× ××××¨× ×©×©×רת ×ת ×××§×©× ×ת×צ××ת.
- ס××: ×××××× × (פר×××)
- curtimestamp
××××× ×ת ××ת×Ö¾×××× ×× ×××× ×ת×צ××.
- ס××: ×××××× × (פר×××)
- responselanginfo
××××× ×ת ×שפ×ת ש×ש×ש×ת ×Ö¾uselang ××Ö¾errorlang ×ת×צ××.
- ס××: ×××××× × (פר×××)
- origin
×עת ×××©× ×Ö¾API ×¢× ×קשת AJAX ×××¦× ×ª××××× (CORS), ×ש ××צ×× ××× ×ת ×ת××× ×©×××§×©× ××צ×ת ××× ×. ×× ××× ××××ת ×××× ××× ××§×©× ×ק××××, ×××× ××× ×××× ××××ת ××ק ××Ö¾URI ×©× ×××§×©× (×× ×××£ ×Ö¾POST).
×¢××ר ×קש×ת ××××ת×ת, ×× ×××× ××××ת ת××× ×××××ק ×××× ××ק×ר×ת ×××תרת
Origin, ×× ×©×× ×¦×¨×× ××××ת ××××ר ××ש×× ××× https://en.wikipedia.org ×× https://meta.wikimedia.org. ×× ×פר××ר ××× ××× × ×ª××× ×××תרתOrigin, ת×××ר תש××ת 403. ×× ×פר××ר ××× ×ª××¨× ×××תרתOrigin×××ק×ר ××רש×, ת××××¨× × ×××תר×תAccess-Control-Allow-Origin×Ö¾Access-Control-Allow-Credentials.×¢××ר ×קש×ת ××ת×Ö¾××××ת×ת, ×ש ×צ××× ×ת ××¢×¨× *. ×× ××ר×× ×××תרת ××××ת
Access-Control-Allow-Origin, ×××Access-Control-Allow-Credentialsת×××false××× ×× ×ª×× ×× ××××××××× ××שת×ש ×××× ×××××××.- uselang
××××× ×©×¤× ××שת×ש ×תר×××× ××××¢×ת. ×קר××× action=query&meta=siteinfo ×¢× siprop=languages ×××××¨× ×¨×©××ת ק××××. צ××× user ××× ××שת×ש ×××¢×פת ××©×¤× ×©× ××שת×ש ×× ××××, ×צ××× content ××שת×ש ×שפת ×ת××× ×©× ×××××§× ×××.
- ×ר×רת ×××××: user
- variant
××××× ×שפ×. ×¢××× ×¨×§ ×× ××©×¤× ××ס×ס×ת ת×××ת ××××¨× ××× ××××× ××.
- errorformat
תס××ר ×ש×××ש ×פ×× ××§×¡× ×××ר×ת ×ש××××ת
- plaintext
- ק×× ×××§× ×©×ª×× HTML ×××¡×¨× ××× × ×××ש×××ת ×××××¤× ××.
- wikitext
- ק×× ×××§× ×× ×פ××¢× ×.
- html
- HTML
- raw
- ××¤×ª× ××××¢× ×פר××ר××.
- none
- ××× ×¤×× ×קס×, רק ××××¢×ת ×ש××××.
- bc
- ×תס××ר שש××ש ××¤× × ××××Ö¾×××§× 1.29. ×תע×××ת ×Ö¾errorlang ×Ö¾ errorsuselocal.
- ××× ××ער××× ×××××: bc, html, none, plaintext, raw, wikitext
- ×ר×רת ×××××: bc
- errorlang
××©×¤× ×©×ª×©×ש ××××ר×ת ×ש××××ת action=query&meta=siteinfo ×¢× siprop=languages ת×××ר רש××ת ק××× ×©×¤×, ××פשר ×× ×צ××× content ××× ××שת×ש ×שפת ×ת××× ×©× ×××××§× ×××, ×× ×צ××× uselang ×¢× ×××ª× ××¢×¨× ×פר××ר uselang.
- ×ר×רת ×××××: uselang
- errorsuselocal
×× × ×ת×, ××קס××× ×©× ×ש××××ת ×שת××©× ×××××¢×ת ××ת×××ת ×ק×××ת ××ר×× ××©× ×××× ××ק×.
- ס××: ×××××× × (פר×××)
- ×¢××¨× ×××××× ×ר×ש×ת.
- api.php?action=help [פת××× ××ר×× ×××]
- ×× ××¢××¨× ×××£ ×××.
- api.php?action=help&recursivesubmodules=1 [פת××× ××ר×× ×××]
ס××× × ×ª×× ××
ק×× ×××××Ö¾×××§× ×××ר ××××ת UTF-8 ×× ×ר×× ××¤× NFC. ××××Ö¾×××§× ××××× ×× ×¡×ת ××××ר ק×× ××ר, ××× ×× ×××× ××ר×× ×פע×××ת ×ס××××ת (×××× ×¢×¨×××ת ×¢× ×××ק×ת MD5) ××××ש×.
פר××ר×× ×©×××××× ×ק×ת ער××× ×ר×××× ××ר×Ö¾××× × ×©×××× ×¢× ×¢×¨××× ××פר××× ×××צע×ת ×ª× ×ק×, ×××©× param=value1|value2 ×× param=value1%7Cvalue2. ×× ××¢×¨× ×¦×¨×× ××××× ×ת ×ª× ××ק×, ×ש ××שת×ש ××ª× U+001F (×פר×× ×××××ת, Unit Separator) ×ת×ר ×פר×× ××× ××ס××¤× ×ת×××ת ××¢×¨× ×ת ××ª× U+001F, ×××©× param=%1Fvalue1%1Fvalue2.
××× ×¡××× ×¤×¨××ר×× ×Ö¾API ××רש×× ×ס×ר × ×סף:
- boolean
פר××ר×× ×××××× ××× ×¢××××× ××× ×ª×××ת ס×××× ×Ö¾HTML: ×× ×פר××ר צ×××, ××× ×§×©×¨ ××¢×¨× ×©××, ××× ××××¤× ×ת×ר ××ת. ×ש××× ×¢×¨× ×©×§×¨, ×ש ××ש××× ×ת ×פר××ר ×××ר×.
- expiry
ער×× ×ª×¤××× ×××××× ××××ת ××ס××× (×××©× 5 months ×× 2 weeks) ×× ××××××× (×××©× 2014-09-18T12:34:56Z). ××× ×©×× ×ª××× ×ª×¤×××, ×ש ××שת×ש ×Ö¾infinite, indefinite, infinity, ×× never.
- timestamp
××ת××Ö¾××× ×××××× ××××ת ×ת×××× ×××× ×ª×¡××ר××, ר' ×ת ×ת××¢×× ×©× ×ª×¡×××¨× ×§×× ×©× ×¡×¤×¨××ת Timestamp ×פר×××. ×××××¥ ××שת×ש ×ת×ר×× ××©×¢× ××¤× ISO 8601, ××: 2001-01-15T14:56:00Z. ×× ×סף, ×××ר××ת now ××××× ×ש×ש ×צ××× ××ת×Ö¾×××× ×× ××××.
פר××ר×× ×ת×× ××ת
×ת××× × "פר××ר×× ×ת×× ××ת" ת×××ת ××קר×× ×©××× ××××× ×©× API ×ק×ק ××¢×¨× ××ש×× ×¢××ר ער××× ×©× ×¤×¨××ר×× ××ר××. ××ש×, ×× ××× ××××× API ××קשת פר×, ××ת×× ×©××× ××× ×ק×ק ×פר××ר ××©× ×¤×ר×ת ××× ×צ××× ××× ×פ×ר×ת ××××קש××, ××פר××ר ×ת×× ×ת ××©× {פר×}-×××ת ××× ×צ××× ×ת ××××ת ×©× ×× ×¤×¨× ×¢××ר ××קש×. ××©× ××, ×ק×× API ש××¢×× ××× ×ק×× ×ª×¤×× ×××, 5 ×× × ×ת ×Ö¾20 ת×ת×× ×××× ××× ××צ×ר ××§×©× ×ס×× ×× ×¤×ר×ת=תפ××××|×× × ×ת|ת×ת××&תפ××××-×××ת=1&×× × ×ת-×××ת=5&ת×ת××-×××ת=20.
קר×××××
×פת×× ×Ö¾API:
- ×××¨× ×ס×ר×× (××צר, ××¤×ª× ××××× ×ספ×××ר 2006 ×¢× ×¡×¤×××ר 2007)
- ר××× ×§××× (××¤×ª× ××××× ×ספ×××ר 2007 ×¢× 2009)
- ××ק××ר ×ס×××××
- ×ר××× ××× × ×××
- ס×× ×¨××
- ×ר×× ××רש (××¤×ª× ××××× ×Ö¾2013 ×¢× 2020)
× × ×ש××× ×ער×ת, ×צע×ת ×ש×××ת ××ת××ת mediawiki-api@lists.wikimedia.org ×× ×ת×× ××××× ××× ××תר https://phabricator.wikimedia.org.