עזרה של MediaWiki API
××× ××£ ת××¢×× ×©× API ×©× ×צר ××××¤× ×××××××.
ת××¢×× ×××××××ת: https://www.mediawiki.org/wiki/API
××××× ×¨×ש×ת
- ×ק×ר: MediaWiki
- ר×ש×××: GPL-2.0+
×צ×: ×× ××פשר×××ת ש××צ××ת ×××£ ××× ×××ר×ת ××¢×××, ××× ×Ö¾API ×¢×××× ×פ×ת×× ×¤×¢××, ××××× ×××©×ª× ×ת ××× ×××. ×¢×©× ××× ×× ×רש××ת ×××××ר mediawiki-api-announce ×××××¢×ת ×¢× ×¢×××× ××.
×קש×ת ש××××ת: ×ש×קש×ת ש××××ת × ×©×××ת ×Ö¾API, ת×ש×× ××תרת HTTP ×¢× ×××¤×ª× "MediaWiki-API-Error" ××× ×× ××¢×¨× ×©× ×××תרת ××× ×§×× ×ש×××× ×××××¨× ××××ª× ×¢×¨×. ×××××¢ × ×סף ר' API: ש××××ת ××××ר×ת.
×××ק×: ×××××§× ×§×× ××תר ×©× ×קש×ת ר' Special:ApiSandbox.
- action
×××× ×¤×¢××× ××צע.
- ××× ××ער××× ×××××: block, changeauthenticationdata, checktoken, clearhasmsg, clientlogin, compare, createaccount, cspreport, 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, stashedit, tag, tokens, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch
- ×ר×רת ××××: help
- format
תס××ר ×פ××.
- ××× ××ער××× ×××××: json, jsonfm, none, php, phpfm, rawfm, xml, xmlfm
- ×ר×רת ××××: jsonfm
- maxlag
ש×××× ×ר×× ×××× ×ש×ש ×ש××××Ö¾×××§× ×××ª×§× ×ª ×צ××ר ×¢× ××¡× × ×ª×× ×× ×ש××פ×. ××× ××ס×× ×פע×××ת ש××ר××ת ××תר ש×××× ×ש×פ×× ×תר, ×פר××ר ××× ×××× ××ר×× ××ק×× ×××ת×× ×¢× ×©×©×××× ×ש×פ×× ×××¨× ×ת×ת ××¢×¨× ×©×¦×××. ×××§×¨× ×©× ×©×××× ×××××, ק×× ×ש×××× maxlag ××××ר ×¢× ××××¢× ××× Waiting for $host: $lag seconds lagged.
ר' ××ר×× ××שת×ש: פר××ר maxlag ×××××¢ × ×סף.- ס××: ×ספר ש××
- smaxage
×××רת ××תרת ×קרת ××××× HTTPâ
s-maxage××ספר ××× ×©× ×©× ××ת.- ס××: ×ספר ש××
- ×ר×רת ××××: 0
- maxage
×××רת ××תרת ×קרת ××××× HTTPâ
max-age××ספר ××× ×©× ×©× ××ת.- ס××: ×ספר ש××
- ×ר×רת ××××: 0
- assert
××××× ×©××שת×ש × ×× ×¡ ×× ×× ××××ר ×Ö¾user, ×× ×©×ש ×× ×רש×ת ××× ×× ×× bot.
- ××× ××ער××× ×××××: user, bot
- 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
- errorformat
תס××ר ×ש×××ש ×פ×× ××§×¡× ×××ר×ת ×ש××××ת.
- plaintext
- ק×× ×××§× ××× ×ª×× HTML ××¢× ×ש×××ת ××××פ×ת.
- wikitext
- ק×× ×××§× ×× ×פ××¢× ×.
- html
- ק×× HTML.
- raw
- ××¤×ª× ××××¢× ×פר××ר××.
- none
- ××× ×¤×× ×קס×, רק ××××¢×ת ×ש××××.
- bc
- ×תס××ר שש××ש ××¤× × ××××Ö¾×××§× 1.29. ×תע×××ת ×Ö¾errorlang ×Ö¾ errorsuselocal.
- ××× ××ער××× ×××××: plaintext, wikitext, html, raw, none, bc
- ×ר×רת ××××: 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) ××××ש×.
××ק ×ס××× ×פר××ר×× ××קש×ת API ××רש×× ×ס×ר × ×סף:
- ×××××× × (boolean)
- פר××ר×× ×××××× ××× ×¢××××× ××× ×ª×××ת ס×××× ×©× HTML: ×× ×פר××ר צ×××, ××× ×§×©×¨ ××¢×¨× ×©××, ××× ××ת (true). ×ש××× ×¢×¨× ×©×§×¨ (false), ×ש ××ש××× ×ת ×פר××ר ×××ר×.
- ××ת×Ö¾××× (timestamp)
- ×פשר ××ת×× ××ת××Ö¾××× ××ספר תס××ר××. ת×ר×× ××©×¢× ××¤× ISO 8601 ××× ×××ר ×××××ת. ×× ×××× ×× ×צ××× ×× ×Ö¾ UTC, ×× ×ª××× ××©×¤×¢× ×ש×× ×××ר ××× ×©×צ×××.
- ת×ר×× ××©×¢× ××¤× ISO 8601â, 2001-01-15T14:56:00Z (×× ×××× ××ת×× ×¤×ס×ק ×Ö¾Z)
- ת×ר×× ××©×¢× ××¤× ISO 8601 ×¢× ×××§× ×©× ××× (ש×× ×ª××× ××× ×©×× ×שפע×), 2001-01-15T14:56:00.00001Z (×× ×××× ××ת×× ×§×××× ×פר××××, × ×§××ת××× ×Ö¾Z)
- תס××ר MediaWikiâ, 20010115145600
- תס××ר ××¡×¤×¨× ××××, 2001-01-15 14:56:00 (××××ר ××× ××פצ××× ×× ×©× GMTâ, +##, ×× -## ××× ×שפע×)
- תס××ר EXIFâ, 2001:01:15 14:56:00
- תס××ר RFC 2822 (×פשר ××ש××× ×ת ×××ר ××××), Mon, 15 Jan 2001 14:56:00
- תס××ר RFC 850 (×פשר ××ש××× ×ת ×××ר ××××), Monday, 15-Jan-2001 14:56:00
- תס××ר C ctimeâ, Mon Jan 15 14:56:00 2001
- ×©× ××ת ××× 1970-01-01T00:00:00Z ×ת×ר ×ספר ש×× ××× 1 ×Ö¾13 (×× ×××× 0)
- ×××ר××ת now
- ×פר×× ×¢×¨××× ×ר×××× ×××פ×
- פר××ר×× ×©××ק××× ×¢×¨××× ×ר×××× ××ר×Ö¾××× × ×©×××× ×¢× ×ער××× ××פר××× ×××צע×ת ×ª× ×ק×, ×××©× param=value1|value2 ×× param=value1%7Cvalue2. ×× ××¢×¨× ×¦×¨×× ××××× ×ת ×ª× ××ק×, ×ש ××שת×ש ×Ö¾U+001F (×פר×× ×××××ת) ×ת×ר ××פר×× ××× ×××ס××£ ×ת×××ת ××¢×¨× U+001F, ×××©× param=%1Fvalue1%1Fvalue2.
קר×××××
×פת×× ×Ö¾API:
- ר××× ×§××× (××¤×ª× ××××× 2007â2009)
- ××ק××ר ×ס×××××
- ×ר××× ××× × ×××
- ס×× ×¨××
- ×××¨× ×ס×ר×× (××צר, ××¤×ª× ××××× ×ספ×××ר 2006 ×¢× ×¡×¤×××ר 2007)
- ×ר×× ××רש (××¤×ª× ××××× ××× 2013)
×× × ×©××× ×ער×ת, ×צע×ת ×ש×××ת ××ת××ת mediawiki-api@lists.wikimedia.org ×× ×ת×× ××××× ××× ××תר https://phabricator.wikimedia.org.