MediaWiki API ่ชชๆ˜Ž

ๆญค้ ็‚บ่‡ชๅ‹•็”ข็”Ÿ็š„ MediaWiki API ่ชชๆ˜Žๆ–‡ไปถ้ ้ขใ€‚

่ชชๆ˜Žๆ–‡ไปถ่ˆ‡็ฏ„ไพ‹๏ผšhttps://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

list=blocks ๏ผˆbk๏ผ‰

๏ผˆmain | query | blocks๏ผ‰
  • ๆญคๆจก็ต„้œ€่ฆ่ฎ€ๅ–ๆฌŠ้™ใ€‚
  • ไพ†ๆบ๏ผšMediaWiki
  • ๆŽˆๆฌŠๆขๆฌพ๏ผšGPL-2.0-or-later

ๅˆ—ๅ‡บๆ‰€ๆœ‰่ขซๅฐ้Ž–ไฝฟ็”จ่€…่ˆ‡ IP ไฝๅ€ใ€‚

ๅ…ท้ซ”ๅƒๆ•ธ๏ผš
ๅ…ถไป–้€š็”จๅƒๆ•ธๅฏ็”จใ€‚
bkstart

่ตทๅง‹ๅˆ—่ˆ‰็š„ๆ™‚้–“ๆˆณ่จ˜ใ€‚

้กžๅž‹๏ผšๆ™‚้–“ๆˆณ่จ˜๏ผˆๅ…่จฑๆ ผๅผ๏ผ‰
bkend

็ต‚ๆญขๅˆ—่ˆ‰็š„ๆ™‚้–“ๆˆณ่จ˜ใ€‚

้กžๅž‹๏ผšๆ™‚้–“ๆˆณ่จ˜๏ผˆๅ…่จฑๆ ผๅผ๏ผ‰
bkdir

ๅˆ—่ˆ‰็š„ๆ–นๅ‘๏ผš

newer
ๆœ€ๆ—ฉ็š„ๅ„ชๅ…ˆใ€‚ๆณจๆ„๏ผšbkstartๆ‡‰ๆ—ฉๆ–ผbkendใ€‚
older
ๆœ€ๆ–ฐ็š„ๅ„ชๅ…ˆ๏ผˆ้ ่จญ๏ผ‰ใ€‚ๆณจๆ„๏ผšbkstartๆ‡‰ๆ™šๆ–ผbkendใ€‚
ๅ–ฎๅ€ผ๏ผšnewerใ€โ€‹older
้ ่จญๅ€ผ๏ผšolder
bkids

่ฆๅˆ—ๅ‡บ็š„ๅฐ้Ž– ID ๆธ…ๅ–ฎ๏ผˆๅฏ้ธ๏ผ‰ใ€‚

้กžๅž‹๏ผšๆ•ดๆ•ธๅˆ—่กจ
ๅฐ‡ๅนพๅ€‹ๅ€ผไปฅ | ๆˆ– alternative ๅˆ†้š”ใ€‚
ๅ€ผ็š„ๆœ€ๅคงๆ•ธ็›ฎ็‚บ 50๏ผˆ็”จๆ–ผๅฎขๆˆถ็ซฏๅ…่จฑ็š„่ผƒ้ซ˜้™ๅˆถ็‚บ 500๏ผ‰ใ€‚
bkusers

่ฆๆœๅฐ‹็š„ไฝฟ็”จ่€…ๆธ…ๅ–ฎ๏ผˆๅฏ้ธ๏ผ‰ใ€‚

้กžๅž‹๏ผšไฝฟ็”จ่€…ๆธ…ๅ–ฎ๏ผŒๆŒ‰ไปปไฝ•ไฝฟ็”จ่€…ๅ็จฑใ€โ€‹IPใ€โ€‹่‡จๆ™‚ไฝฟ็”จ่€…ๅ’Œโ€‹IP ็ฏ„ๅœ
ๅฐ‡ๅนพๅ€‹ๅ€ผไปฅ | ๆˆ– alternative ๅˆ†้š”ใ€‚
ๅ€ผ็š„ๆœ€ๅคงๆ•ธ็›ฎ็‚บ 50๏ผˆ็”จๆ–ผๅฎขๆˆถ็ซฏๅ…่จฑ็š„่ผƒ้ซ˜้™ๅˆถ็‚บ 500๏ผ‰ใ€‚
bkip

ๅ–ๅพ—ๅฅ—็”จๅœจๆญค IP ไฝๅ€ๆˆ– CIDR ็ฏ„ๅœ็š„ๆ‰€ๆœ‰ๅฐ้Ž–่ˆ‡ๆ‰€ๅŒ…ๅซ็š„็ฏ„ๅœๅฐ้Ž–ใ€‚ไธๅฏ่ˆ‡ bkusers ไธ€่ตทไฝฟ็”จใ€‚CIDR ็ฏ„ๅœไธๅฏ่ถ…้Ž IPv4/16 ๆˆ– IPv6/19ใ€‚

bklimit

่ƒฝๅˆ—ๅ‡บๅฐ้Ž–็š„ๆœ€ๅคงๆ•ธ้‡ใ€‚

้กžๅž‹๏ผšๆ•ดๆ•ธๆˆ–max
ๆ•ธๅ€ผๅฟ…้ ˆๅœจ 1 ่ˆ‡ 500 ไน‹้–“ใ€‚
้ ่จญๅ€ผ๏ผš10
bkprop

่ฆๅ–ๅพ—็š„ๅฑฌๆ€งใ€‚

id
ๆทปๅŠ ๅฐ้Ž– IDใ€‚
user
ๆทปๅŠ ๅทฒๅฐ้Ž–ไฝฟ็”จ่€…็š„ไฝฟ็”จ่€…ๅ็จฑใ€‚
userid
ๆทปๅŠ ๅทฒๅฐ้Ž–ไฝฟ็”จ่€…็š„ไฝฟ็”จ่€… IDใ€‚
by
ๅŠ ๅ…ฅๅŸท่กŒๅฐ้Ž–็š„ไฝฟ็”จ่€…ๅ็จฑใ€‚
byid
ๆ–ฐๅขžๅŸท่กŒๅฐ้Ž–่€…็š„ไฝฟ็”จ่€…IDใ€‚
timestamp
ๆทปๅŠ ็•ถๅฐ้Ž–็”Ÿๆ•ˆ็š„ๆ™‚้–“ๆˆณ่จ˜ใ€‚
expiry
ๆทปๅŠ ็•ถๅฐ้Ž–ๅˆฐๆœŸ็š„ๆ™‚้–“ๆˆณ่จ˜ใ€‚
reason
ๆทปๅŠ ๅฐ้Ž–็š„ๅŽŸๅ› ใ€‚
range
ๆทปๅŠ ๅ—ๅฐ้Ž–ๅฝฑ้Ÿฟ็š„ IP ๅœฐๅ€็ฏ„ๅœใ€‚
flags
ไปฅ่‡ชๅ‹•ๅฐ้Ž–ใ€ๅƒ…้™ๅŒฟๅใ€ๆˆ–ๅ…ถๅฎƒไพ†ๆจ™่จ˜่ฉฒ็ฆไปคใ€‚
restrictions
่‹ฅๅฐ้Ž–้žๆ•ดๅ€‹็ถฒ็ซ™็ฏ„ๅœ๏ผŒๆทปๅŠ ้ƒจไปฝๅฐ้Ž–้™ๅˆถใ€‚
ๅคšๅ€ผ (ไปฅ | ๆˆ– alternative ๅˆ†้š”)๏ผšbyใ€โ€‹byidใ€โ€‹expiryใ€โ€‹flagsใ€โ€‹idใ€โ€‹rangeใ€โ€‹reasonใ€โ€‹restrictionsใ€โ€‹timestampใ€โ€‹userใ€โ€‹userid
้ ่จญๅ€ผ๏ผšid|user|by|timestamp|expiry|reason|flags
bkshow

ๅƒ…้กฏ็คบ็ฌฆๅˆ้€™ไบ›ๆจ™ๆบ–็š„้ …็›ฎใ€‚ ไพ‹ๅฆ‚ๅƒ…ๆƒณๆŸฅ็œ‹ๅœจ IP ๅœฐๅ€็š„็„ก้™ๆœŸๅฐ้Ž–๏ผŒ่ซ‹่จญๅฎš bkshow=ip|!tempใ€‚

ๅคšๅ€ผ (ไปฅ | ๆˆ– alternative ๅˆ†้š”)๏ผš!accountใ€โ€‹!ipใ€โ€‹!rangeใ€โ€‹!tempใ€โ€‹accountใ€โ€‹ipใ€โ€‹rangeใ€โ€‹temp
bkcontinue

็•ถๆ›ดๅคš็ตๆžœๅฏ็”จๆ™‚๏ผŒไฝฟ็”จ้€™ๅ€‹็นผ็บŒใ€‚ๅฏๅœจ mediawiki.org ๅ–ๅพ—ๆ›ดๅคšๆœ‰้—œๅฆ‚ไฝ•็นผ็บŒๆŸฅ่ฉข็š„่ฉณ็ดฐ่ณ‡่จŠใ€‚

็ฏ„ไพ‹๏ผš
ๅˆ—ๅ‡บๅฐ้Ž–ใ€‚
api.php?action=query&list=blocks [ๅœจๆฒ™็›’ไธญ้–‹ๅ•Ÿ]
ๅˆ—ๅ‡บไฝฟ็”จ่€… Alice ่ˆ‡ Bob ็š„ๅฐ้Ž–ใ€‚
api.php?action=query&list=blocks&bkusers=Alice|Bob [ๅœจๆฒ™็›’ไธญ้–‹ๅ•Ÿ]