MediaWiki API 說明
æ¤é çºèªåç¢çç MediaWiki API 說ææä»¶é é¢ã
說ææä»¶èç¯ä¾ï¼https://www.mediawiki.org/wiki/API
action=upload
(main | upload)
- æ¤æ¨¡çµéè¦è®åæ¬éã
- æ¤æ¨¡çµéè¦å¯«å ¥æ¬éã
- æ¤æ¨¡çµå æ¥å POST è«æ±ã
- æ¥æºï¼MediaWiki
- 许å¯åè®®ï¼GPL-2.0+
ä¸ä¼ ä¸ä¸ªæä»¶ï¼æè·åæ£å¨çå¾ ä¸çä¸ä¼ çç¶æã
å¯ä»¥ä½¿ç¨çå ç§æ¹æ³ï¼
- ç´æ¥ä¸ä¼ æä»¶å 容ï¼ä½¿ç¨fileåæ°ã
- ææ¹ä¸ä¼ æä»¶ï¼ä½¿ç¨filesizeãchunkåoffsetåæ°ã
- æMediaWikiæå¡å¨ä»URLæ£ç´¢ä¸ä¸ªæä»¶ï¼ä½¿ç¨urlåæ°ã
- 宿䏿¬¡ç±äºè¦åèå¤±è´¥çæ©åä¸ä¼ ï¼ä½¿ç¨filekeyåæ°ã
éè¦æ³¨æï¼å½åéfileæ¶ï¼HTTP POSTå¿
é¡»åä¸ºä¸æ¬¡æä»¶ä¸ä¼ ï¼ä¹å°±æ¯ä½¿ç¨multipart/form-dataï¼å®æã
- filename
ç®æ æä»¶åã
- comment
ä¸ä¼ 注éãå¦ææ²¡ææå®textï¼é£ä¹å®ä¹è¢«ç¨äºæ°æä»¶çåå§é¡µé¢ææ¬ã
- é è¨å¼ï¼(空)
- tags
æ´æ¹æ ç¾ä»¥åºç¨äºä¸ä¼ æ¥å¿è®°å½åæä»¶é¡µé¢ä¿®è®¢ä¸ã
- å¤å¼ (以 | åé)ï¼
- text
ç¨äºæ°æä»¶çåå§é¡µé¢ææ¬ã
- watch
- å·²åç¨ã
çè§é¡µé¢ã
- ç±»åï¼å¸å°å¼ï¼è¯¦ç»ä¿¡æ¯ï¼
- watchlist
æ æ¡ä»¶å°å°é¡µé¢å å ¥è³å½åç¨æ·ççè§å表æå°å ¶ç§»é¤ï¼ä½¿ç¨è®¾ç½®æä¸æ´æ¹çè§ã
- å®å¼ï¼watchï¼preferencesï¼nochange
- é è¨å¼ï¼preferences
- ignorewarnings
忽ç¥ä»»ä½è¦åã
- ç±»åï¼å¸å°å¼ï¼è¯¦ç»ä¿¡æ¯ï¼
- file
æä»¶å 容ã
- å¿ é ä½¿ç¨ multipart/form-data ä»¥æªæ¡ä¸å³çæ¹å¼å³éã
- url
è¦æ£ç´¢æä»¶æ¥æºçURLã
- filekey
ç¨äºè¯å«ä¸æ¬¡ä¸´æ¶èå¿çæ©åä¸ä¼ çå ³é®åã
- sessionkey
- å·²åç¨ã
ä¸filekeyç¸åï¼åºäºååå ¼å®¹èç»´æ¤ã
- stash
å¦æè®¾ç½®ï¼æå¡å¨å°ä¸´æ¶èå¿æä»¶è䏿¯å å ¥åå¨åºã
- ç±»åï¼å¸å°å¼ï¼è¯¦ç»ä¿¡æ¯ï¼
- filesize
å ¨é¨ä¸ä¼ çæä»¶å¤§å°ã
- æ¸å¼å¿ é å¨ 0 è 104,857,600 ä¹éã
- ç±»åï¼æ´æ°
- offset
æ°æ®åçåç§»éï¼åèï¼ã
- æ¸å¼ä¸å¯å°æ¼ 0ã
- ç±»åï¼æ´æ°
- chunk
大åå 容ã
- å¿ é ä½¿ç¨ multipart/form-data ä»¥æªæ¡ä¸å³çæ¹å¼å³éã
- async
å¨å¯è½çæ åµä¸ï¼ä½¿æ½å¨ç大æä»¶æä½å¼æ¥è¿è¡ã
- ç±»åï¼å¸å°å¼ï¼è¯¦ç»ä¿¡æ¯ï¼
- checkstatus
åªæ£ç´¢æå®æä»¶å¯é¥çä¸ä¼ ç¶æã
- ç±»åï¼å¸å°å¼ï¼è¯¦ç»ä¿¡æ¯ï¼
- token
èª action=query&meta=tokens æ¥æ¶ç "csrf" å¯é°ã
- æ¤åæ¸çºå¿ å¡«ã
- ä»URLä¸ä¼ ã
- api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [卿²ç䏿å¼]
- 宿䏿¬¡ç±äºè¦åè失败çä¸ä¼ ã
- api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [卿²ç䏿å¼]