本WIKI由闪耀暖暖山药攻略组申请于2020年04月24日创建,编辑权限开放。
Api使用示例
阅读
2020-05-17更新
最新编辑:迦洛翎
阅读:
更新日期:2020-05-17
最新编辑:迦洛翎
api帮助页面
https://wiki.biligame.com/wiki/api.php
api沙盒页面
https://wiki.biligame.com/wiki/%E7%89%B9%E6%AE%8A:ApiSandbox
账号信息
获取令牌
queryTokens
请求方式 | POST | |
---|---|---|
请求参数 | action=query&format=json&meta=tokens | { "action": "query", "format": "json", "meta": "tokens" } |
返回取值 | data["query"]["tokens"]["csrftoken"] | |
关键值类型 | string csrftoken = "052e5d9da3c1ae623fad6743659b590d5ebf6809+\\" | |
使用注意 | 目前调用api主要使用csrftoken,token有一定时效,当失效后要重新获取新的token。 |
检查令牌有效性
checkToken
请求方式 | POST | |
---|---|---|
请求参数 | action=checktoken&format=json&type=csrf&token=052e5d9da3c1ae623fad6743659b590d5ebf6809%2B%5C | { "action": "checktoken", "format": "json", "type": "csrf", "token": "052e5d9da3c1ae623fad6743659b590d5ebf6809+\\" } |
返回取值 | data["checktoken"]["result"] | |
关键值类型 | string result = "invalid" | |
使用注意 | 本例中使用的token是已过期的,所以会返回"invalid"(无效),正常情况应返回"valid"(有效)。
请注意使用时符号转义的问题!
|
页面操作
生成页面
addPage
请求方式 | POST | |
---|---|---|
请求参数 | action=edit&format=json&title=测试&text=测试页面&createonly=1&token=1592f711e63890271520e50f3d3f41935ec0839a%2B%5C | { "action": "edit", "format": "json", "title": "测试", "text": "测试页面", "createonly": 1, "token": "1592f711e63890271520e50f3d3f41935ec0839a+\\" } |
返回取值 | data["edit"]["result"] | |
关键值类型 | string result = "Success" | |
错误处理 | data["error"] --- print ---> data["error"]["code"] | |
使用注意 | 若要添加的页面已存在,则会提示"articleexists"。 |
修改页面内容
editPage
请求方式 | POST | |
---|---|---|
请求参数 | action=edit&format=json&title=测试&text=测试页面&nocreate=1&token=1592f711e63890271520e50f3d3f41935ec0839a%2B%5C | { "action": "edit", "format": "json", "title": "测试", "text": "测试页面2", "nocreate": 1, "token": "1592f711e63890271520e50f3d3f41935ec0839a+\\" } |
返回取值 | data["edit"]["result"] | |
关键值类型 | string result = "Success" | |
错误处理 | data["error"] --- print ---> data["error"]["code"] | |
使用注意 | 若要修改的页面不存在,则会提示"missingtitle"。 |
删除页面
deletePage
移动(重命名)页面
action=move
刷新页面(清除缓存)
action=purge
撤销最近编辑(回退页面版本)
action=rollback
内容操作
获取页面内容
action=query