T00ls官方API接口


1. 查询文章列表接口

接口功能

获取各类型的文章列表

URL

https://www.t00ls.com/{type}-articles.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
type ture string 请求的文章类型。
page false int 页数,数字型。

文章类型包括All、Official、HR、News、Vuls、People、Law、Love、Tech、Penetration、Web、Code、CTF、Wireless、Reverse、Social。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
articleslist json 失败则为空,成功结果如下。
tid int 文章ID。
subject string 文章标题。
message string 文章部分内容。
dateline string 文章发布时间。
fid int 版块ID。
views int 阅读次数。
links string 文章链接。
replies int 评论次数。
pic string 文章图片URL。

接口示例

地址:https://www.t00ls.com/All-articles.json

{"status":"success","articleslist":[{"tid":"55500","subject":"\u9700\u8981\u4e00\u4e2a\u8fc7\u8d5b\u95e8\u94c1\u514b\u7684mimikatz \u5728\u7ebf\u7b49","message":"\u9700\u8981\u4e00\u4e2a\u8fc7\u8d5b\u95e8\u94c1\u514b\u7684mimikatz \u5728\u7ebf\u7b49","dateline":"5 \u5206\u949f\u524d","attachment":"0","fid":"40","views":"0","replies":"0","pic":"images\/nopic.png","links":"articles-55500.html"},......]}

2. 查询用户信息接口

接口功能

获取用户信息

URL

https://www.t00ls.com/members-profile.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
uid false int 用户ID,数字型。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
memberinfo json 失败则为空,成功结果如下。
uid int 用户ID。
username string 用户名。
authortitle string 用户组。
email string 邮箱。若查看当前登录用户,则显示 。
posts int 发帖数。
threads int 主题帖数。
extcredits1 int TCV数目。
extcredits2 int TuBi数目。
nickname string 昵称。
customstatus string 自定义状态。
bio string 用户签名。
medals json 用户勋章。
field_1 string 认证信息。
field_3 string 微博地址。
sign_times int 签到次数。
sign_today int 今日是否签到。
age int 坛龄。
avatar string 用户头像URL。
formhash string formhash,提交时使用。

接口示例

地址:https://www.t00ls.com/members-profile.json

{"status":"success","memberinfo":{"username":"t00ls\u7ba1\u7406\u56e2\u961f01","email":"admin@t00ls.net","posts":"2155","threads":"625","extcredits1":"41","extcredits2":"745","extcredits3":"665","nickname":"\u5475\u5475...","customstatus":"\u6211\u4eec\u4e00\u76f4\u5728\u52aa\u529b ...","bio":"\u52aa\u529b\u5efa\u8bbeT00ls\u2026\u2026\u52aa\u529b\u5efa\u8bbeT00ls\u2026\u2026","medals":[{"name":"\u6d3b\u8dc3\u4f1a\u5458\u52cb\u7ae0","image":"medal5.gif"},{"name":"\u4e94\u5e74\u9648\u8001\u4f1a\u5458\u52cb\u7ae0","image":"medal11.gif"},{"name":"T00ls\u571f\u8c6a\u52cb\u7ae0","image":"medal12.gif"}],"field_1":"T00ls\u8ba4\u8bc1\u7ba1\u7406\u5458\uff0c\u5982\u9700\u8ba4\u8bc1\uff0c\u8bf7\u8054\u7cfbadmin@t00ls.net","field_2":"http:\/\/t.qq.com\/T00lsSecurity","field_3":"http:\/\/weibo.com\/t00lsnet","sign_times":"1","sign_today":"0","dateline":"48 \u79d2\u524d","uid":"5872","authortitle":"\u7ba1\u7406\u56e2\u961f","age":2836,"avatar":"https:\/\/www.t00ls.com\/uc_server\/data\/avatar\/000\/00\/58\/72_avatar_middle.jpg","formhash":"80a7e0c2"}}

3. 用户登录接口

接口功能

用户登录

URL

https://www.t00ls.com/login.json

支持格式

JSON

HTTP请求方式

POST

请求参数

参数 必选 类型 说明
action true string 值为“login”。
username true string 用户名。
password true string 用户密码,MD5值。
questionid true int 用户提问问题ID,数字型。
answer true string 用户提问答案。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
message string 返回登录详情。
formhash string formhash,登录成功返回,提交时使用。

接口示例

地址:https://www.t00ls.com/login.json

{"status":"success","memberinfo":"login_invalid"}

4. 用户签到接口

接口功能

用户签到

URL

https://www.t00ls.com/ajax-sign.json

支持格式

JSON

HTTP请求方式

POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
formhash true string formhash。
signsubmit true string 值为“true”。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
message string 返回签到详情。

接口示例

地址:https://www.t00ls.com/ajax-sign.json

{"status":"success","memberinfo":"alreadysign"}

5. 用户补签接口

接口功能

用户补签,需支付20TuBi

URL

https://www.t00ls.com/ajax-busign.json

支持格式

JSON

HTTP请求方式

POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
formhash true string formhash。
signsubmit true string 值为“true”。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
message string 返回签到详情。

接口示例

地址:https://www.t00ls.com/ajax-busign.json

{"status":"success","memberinfo":"wrongbusubmit"}

6. 查询名人堂接口

接口功能

获取名人堂信息

URL

https://www.t00ls.com/ajax-hof.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数

无

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
memberinfo json 失败则为空,成功结果如下。
uid int 用户ID。
username string 用户名。
authortitle string 用户组。
ulinks string 用户链接 。
intro string 介绍或者获奖感言 。
avatar string 用户头像URL。

接口示例

地址:https://www.t00ls.com/ajax-hof.json

{"status":"success","0":{"hoflist2008":[{"year":"2008","uid":"4","intro":"bloodsword\uff0c\u91cd\u5e86\u67d0\u7f51\u7edc\u5b89\u5168\u516c\u53f8\uff0c\u7f51\u7edc\u5b89\u5168\u5de5\u7a0b\u5e08\u3002","username":"bloodsword","ulinks":"members-profile-4.html","avatar":"https:\/\/www.t00ls.com\/uc_server\/data\/avatar\/000\/00\/00\/04_avatar_middle.jpg","authortitle":"\u5143\u8001\u6838\u5fc3"},......]}}

7. 查询用户文章接口

接口功能

获取用户文章

URL

https://www.t00ls.com/members-topics.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
uid false int 用户ID,数字型。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
topicslist json 失败则为空,成功结果如下。
tid int 文章ID。
fid int 版块ID。
authorid int 作者ID。
subject string 文章标题。
highlight string 文章高亮。
dateline string 文章发布时间。
lastposter string 文章最后回复人。
views int 阅读次数。
links string 文章链接。
replies int 评论次数。
flinks string 文章类型链接。
fname string 文章类型名称。

接口示例

地址:https://www.t00ls.com/members-topics.json

{"status":"success","topicslist":[{"tid":"55279","fid":"39","authorid":"5872","subject":"T00ls\u5f00\u901a\u5b98\u65b9Telegram\u9891\u9053\uff08Channel\uff09","dateline":"2020-3-6 20:46","highlight":" style=\"font-weight: bold;color: #EE1B2E;\"","views":"2212","replies":"58","lastposter":"gao409115900","links":"articles-55279.html","flinks":"Official-articles.html","fname":"\u8bba\u575b\u4e8b\u52a1(Forum Affairs)","lastposteruid":4859},......]}

8. 查询用户评论接口

接口功能

获取用户评论

URL

https://www.t00ls.com/members-replies.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
uid false int 用户ID,数字型。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
replieslist json 失败则为空,成功结果如下。
pid int 评论ID。
tid int 文章ID。
fid int 版块ID。
author string 文章作者。
authorid int 文章作者ID。
message string 评论内容。
dateline string 评论发布时间。

接口示例

地址:https://www.t00ls.com/members-replies.json

{"status":"success","replieslist":[{"pid":"917867","tid":"55444","fid":"39","dateline":"<span title=\"2020-3-17 16:32\">4&nbsp;\u5929\u524d&nbsp;16:32<\/span>","message":"\u5148\u5728Tg\u673a\u5668\u4eba\u4e2d\u4f7f\u7528\u201c\u4e00\u952e\u767b\u5f55\u201d\u767b\u5f55\u4e0b\u5373\u53ef\u3002","status":"0","author":"gao409115900","authorid":"4859"},......]}

9. 查询当前用户收藏夹接口

接口功能

获取当前用户收藏夹

URL

https://www.t00ls.com/members-favorites.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

无

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
favlist json 失败则为空,成功结果如下。
tid int 文章ID。
fid int 版块ID。
author string 文章作者。
authorid int 文章作者ID。
subject string 文章标题。
highlight string 文章高亮。
dateline string 文章发布时间。
lastposter string 文章最后回复人。
views int 阅读次数。
links string 文章链接。
replies int 评论次数。
flinks string 文章类型链接。
fname string 文章类型名称。

接口示例

地址:https://www.t00ls.com/members-favorites.json

{"status":"success","favlist":[{"tid":"30250","fid":"47","subject":"\u6e17\u900fJDM.LA, \u7206y35u\u83ca\u82b1, \u4e3aFREEBUF\u62a5\u4ec7!!!!","author":"Rices","authorid":"5336","views":"8088","replies":"155","dateline":"2015-6-12 03:54","lastposter":"NeverSec","name":"\u6e17\u900f\u6d4b\u8bd5\u6587\u7ae0(Security Articles)","links":"articles-30250.html","flinks":"Penetration-articles.html","highlight":"","fname":"\u6e17\u900f\u6d4b\u8bd5\u6587\u7ae0(Security Articles)","lastposteruid":12824},......]}

10. 查询当前用户论坛币日志接口

接口功能

获取当前用户Tcv、TuBi日志等

URL

https://www.t00ls.com/members-{type}.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
type true string 类型,可选为tubilog、cvlog、ssbilog。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
loglist json 失败则为空,成功结果如下。
id int 日志ID。
uid int 用户ID。
type int 货币类型。
porm int 赚得还是消费。
money int 数目。
cmoney int 剩余数目。
reason string 发生原因。
dateline string 发生时间。

接口示例

地址:https://www.t00ls.com/members-tubilog.json

{"status":"success","loglist":[{"id":"801895","uid":"5872","type":"2","porm":"2","money":"-20","cmoney":"745","reason":"\u8d2d\u4e70\u9080\u8bf7\u7801\uff0c\u6570\u76ee\uff1a1","mark":"1","timeline":"2020-03-20 17:34:57","i":1,"color":"green"},......]}

11. 查询当前用户足迹接口

接口功能

获取当前用户访问记录

URL

https://www.t00ls.com/members-visitlog.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

无

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
articlelist json 失败则为空,成功结果如下。
tid int 文章ID。
fid int 版块ID。
authorid int 文章作者ID。
subject string 文章标题。
highlight string 文章高亮。
dateline string 文章发布时间。
lastposter string 文章最后回复人。
views int 阅读次数。
links string 文章链接。
replies int 评论次数。
flinks string 文章类型链接。
fname string 文章类型名称。

接口示例

地址:https://www.t00ls.com/members-visitlog.json

{"status":"success","articlelist":[{"tid":"55516","fid":"52","authorid":"6962","subject":"\u514d\u6740\u7248mimikatz","dateline":"<span title=\"2020-3-21 18:58\">1&nbsp;\u5c0f\u65f6\u524d<\/span>","highlight":"","views":"124","replies":"5","lastposter":"cimoom","links":"articles-55516.html","flinks":"forum-52-1.html","fname":"\u539f\u521b\u6587\u7ae0\u53d1\u5e03(Original Article)","lastposteruid":7808},......]}

12. 查询当前用户所有新消息接口

接口功能

获取当前用户所有新消息,含好友消息、系统消息、帖子消息。

URL

https://www.t00ls.com/new-messages.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
page false int 页数,数字型。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
messagelist json 失败则为空,成功结果含friend_msg、system_msg、thread_msg。
friend_msg json 含friend_msg_num、friend_msg_list。
friend_msg_list json 消息内容如下。
msgfromid int 发信用户ID。
pmid int 消息ID。
msgfrom string 发信人用户名。
dateline string 消息发送时间。
message string 消息内容。
system_msg json system_msg_num、system_msg_list。
system_msg_list json 消息内容如下。
id int 消息ID。
dateline string 消息发送时间。
message string 消息内容。
thread_msg json thread_msg_num、thread_msg_list。
thread_msg_list json 消息内容如下。
id int 消息ID。
dateline string 消息发送时间。
message string 消息内容。

接口示例

地址:https://www.t00ls.com/new-messages.json

{"status":"success","messagelist":{"friend_msg":{"friend_msg_num":4,"friend_msg_list":[{"msgfromid":"13274","pmid":"90273","msgfrom":"Geekby","dateline":"2019-11-16 11:12:47","message":"......"},......]},"system_msg":{"system_msg_num":23,"system_msg_list":[{"id":"586313","dateline":"2020-03-21 14:12:07","message":"......"},......]},"thread_msg":{"thread_msg_num":1,"thread_msg_list":[{"id":"586206","dateline":"2020-03-20 21:46:24","message":"......","actor":""}]}}}

13. 查询当前用户好友消息接口

接口功能

获取当前用户好友消息

URL

https://www.t00ls.com/friend-messages.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
msgfromid true int 发信人ID。
page false int 页数,数字型。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
messagelist json 失败则为空,成功结果如下。
pmid int 消息ID。
msgfromid int 发信用户ID。
msgfrom string 发信人用户名。
msgtoid int 收信用户ID。
dateline string 消息发送时间。
message string 消息内容。
new int 是否新消息。

接口示例

地址: https://www.t00ls.com/friend-messages.json

{"status":"success","messagelist":[{"pmid":"88507","msgfromid":"5872","msgfrom":"t00ls\u7ba1\u7406\u56e2\u961f01","msgtoid":"13065","dateline":"2019-08-30 20:53:38","message":"......","new":"0"},......]}

14. 查询当前用户系统消息接口

接口功能

获取当前用户系统消息

URL

https://www.t00ls.com/system-messages.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
page false int 页数,数字型。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
messagelist json 失败则为空,成功结果如下。
id int 消息ID。
dateline string 消息发送时间。
message string 消息内容。
new int 是否新消息。

接口示例

地址:https://www.t00ls.com/system-messages.json

{"status":"success","messagelist":[{"id":"586313","dateline":"2020-03-21 14:12:07","message":"......","new":"1","actor":""},......]}

15. 查询当前用户帖子消息接口

接口功能

获取当前用户系统消息

URL

https://www.t00ls.com/thread-messages.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
page false int 页数,数字型。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
messagelist json 失败则为空,成功结果如下。
id int 消息ID。
dateline string 消息发送时间。
message string 消息内容。
new int 是否新消息。

接口示例

地址:https://www.t00ls.com/thread-messages.json

{"status":"success","messagelist":[{"id":"586206","dateline":"2020-03-20 21:46:24","message":".......","new":"1","actor":""}]}

16. 发送好友消息接口

接口功能

发送好友消息

URL

https://www.t00ls.com/friend-messages.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
action true string 值为“send”。
msgtoid true int 目标用户ID。
message true string 消息内容。
sendsubmit true string 值为“true”。
formhash true string formhash。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。

接口示例

地址:https://www.t00ls.com/friend-messages.json

{"status":"success"}

17. 设置消息已读接口

接口功能

设置消息已读

URL

https://www.t00ls.com/{type}-messages.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
type true string friend、system、thread三个类型。
action true string 值为“read”。
id true int 消息ID,friend类型时参数为“pmid”。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。

接口示例

地址:https://www.t00ls.com/friend-messages.json

{"status":"success"}

18. 删除消息接口

接口功能

删除消息,删除全部消息

URL

https://www.t00ls.com/{type}-messages.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
type true string friend、system、thread三个类型。
action true string 值为“del”,全部删除时值为“alldel”。
id true int 消息ID,friend类型时参数为“pmid”,全部删除时无此参数。
delsubmit true string 值为“true”,全部删除时参数为“alldelsubmit”。
formhash true string formhash。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。

接口示例

地址:https://www.t00ls.com/friend-messages.json

{"status":"success"}

19. 查询文章详情接口

接口功能

获取单篇文章详情(正文渲染HTML、附件图片、信息分类字段),可选附带评论分页

URL

https://www.t00ls.com/articles-{tid}.json

支持格式

JSON

HTTP请求方式

GET(游客仅限白名单版块或对外展示帖)

请求参数(使用Cookie请求)

参数 必选 类型 说明
replies false int 传1时附带评论列表。
page false int 评论页数,默认1,每页10条。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
article json 失败则为空,成功结果如下。
tid int 文章ID。
fid int 版块ID。
forumname string 版块名称。
subject string 文章标题。
author string 作者用户名。
authorid int 作者用户ID。
dateline string 发布时间。
views int 阅读次数。
replies int 评论次数。
digest int 精华等级,0为普通。
special int 特殊主题类型,0为普通,1投票,3悬赏。
message_html string 正文渲染后的HTML。
attachments json 图片附件列表,每项含aid(附件ID)、name(原名)、url(图片URL)、size(字节)、downloads(次数)。
sortfields json 信息分类字段,键为字段标识(如news_from),值为{title, value}。
links string 文章链接。
replies_total int 评论总数(replies=1时返回)。
replies_page int 当前评论页码(replies=1时返回)。
replies_list json 评论列表(replies=1时返回),每项含floor(楼层)、pid(评论ID)、author(作者)、authorid、dateline、message_html(渲染HTML)。

20. 搜索接口

接口功能

按标题搜索主题

URL

https://www.t00ls.com/search.json?keyword=xxx

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
keyword true string 关键词,至少2字符,标题搜索。
page false int 页数,每页20条。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
total int 结果总数。
page int 当前页码。
searchlist json 失败则为空,成功结果如下。
tid int 文章ID。
fid int 版块ID。
forumname string 版块名称。
subject string 文章标题。
author string 作者用户名。
authorid int 作者用户ID。
dateline string 发布时间。
views int 阅读次数。
replies int 评论次数。
links string 文章链接。

21. 发帖接口

接口功能

发布新主题(权限、字数、审核等校验与网页端一致)

URL

https://www.t00ls.com/post.json

支持格式

JSON

HTTP请求方式

POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
mode true string 值为"newthread"。
fid true int 版块ID。
subject true string 标题。
message true string 正文,支持Markdown,遵守版块字数规则。
typeid false int 分类ID。
special false int 特殊帖类型:1=投票帖,3=悬赏帖(不传或0为普通帖;版块需开启对应类型)。
polloptions false string 投票帖(special=1)选项,换行分隔,至少2项;也可用 polloption[] 数组重复传参。
multiplepoll false int 投票帖:是否多选,1=多选。
maxchoices false int 投票帖:多选时最多可选数。
visibilitypoll false int 投票帖:1=投票后可见结果。
overt false int 投票帖:1=公开投票人。
expiration false int 投票帖:有效天数,0=永不过期。
rewardprice false int 悬赏帖(special=3)悬赏TuBi数,须≥用户组最低悬赏额且不超余额。
postsubmit true string 值为"yes"。
formhash true string formhash,提交时使用。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
tid int 新主题ID(成功时返回)。
links string 新主题链接(成功时返回)。
message string 失败时为论坛原始提示(如字数不足、无权限、待审核等)。

22. 回复接口

接口功能

回复主题(权限、字数、防刷等校验与网页端一致)

URL

https://www.t00ls.com/post.json

支持格式

JSON

HTTP请求方式

POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
mode true string 值为"reply"。
tid true int 主题ID。
message true string 回复内容,支持Markdown。
postsubmit true string 值为"yes"。
formhash true string formhash,提交时使用。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
tid int 主题ID。
pid int 新回复ID(成功时返回)。
message string 失败时为论坛原始提示。

23. 收藏接口

接口功能

添加或取消收藏主题

URL

https://www.t00ls.com/favorite.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
action true string add(收藏)或del(取消)。
tid true int 主题ID。
favaddsubmit / favdelsubmit true string 与action对应,值为"yes"。
formhash true string formhash,提交时使用。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
tid int 操作的主题ID。
favorites int 当前收藏总数。

24. 图片上传接口

接口功能

上传图片(与编辑器批量上传同一后端,自动去重、水印)

URL

https://www.t00ls.com/upload.json

支持格式

JSON

HTTP请求方式

POST(multipart/form-data)

请求参数(使用Cookie请求)

参数 必选 类型 说明
file true file 图片文件,支持jpg/jpeg/png/gif/webp/bmp,上限10M。
formhash true string formhash,提交时使用。

返回字段

返回字段 字段类型 说明
err int 0成功,1失败。
aid int 附件ID(成功时返回)。
url string 图片URL,正文以 ![图片](url) 形式引用(成功时返回)。
msg string 提示信息(失败或重复上传时返回)。
dup int 1表示该图片此前已上传过,已关联既有文件。

25. 打赏/拍砖接口

接口功能

对他人主题打赏或拍砖(含10%税费,不能操作自己发表的帖子,同一主题仅允许一次)

URL

https://www.t00ls.com/rate.json

支持格式

JSON

HTTP请求方式

POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
tid true int 主题ID。
do true string dashang(打赏)或paizhuan(拍砖)。
score true int 数量,1-49。实际扣除为数量+10%税费。
reason true string 理由,不能为空。
ratesubmit true string 值为"yes"。
formhash true string formhash,提交时使用。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
tid int 操作的主题ID。
message string 失败时为论坛原始提示(如TuBi不足、重复操作等)。

26. 投票接口

接口功能

参与投票(重复投票、过期、超选项数等校验与网页端一致)

URL

https://www.t00ls.com/vote.json

支持格式

JSON

HTTP请求方式

POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
tid true int 投票主题ID。
pollanswers[] true int 选项ID,可传多个。
pollsubmit true string 值为"yes"。
formhash true string formhash,提交时使用。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
tid int 投票主题ID。
message string 失败时为论坛原始提示(如已投过票、投票过期等)。

27. 好友接口

接口功能

添加或删除好友

URL

https://www.t00ls.com/friend.json

支持格式

JSON

HTTP请求方式

GET,POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
action true string add(添加)或del(删除)。
uid true int 目标用户ID。
friendsubmit true string 值为"yes"。
formhash true string formhash,提交时使用。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
uid int 操作的目标用户ID。

28. 修改资料接口

接口功能

修改当前登录用户的资料项

URL

https://www.t00ls.com/myprofile.json

支持格式

JSON

HTTP请求方式

POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
bio false string 个性签名,上限200字。
site false string 个人主页,上限100字。
qq false string QQ,上限100字。
github false string GitHub,上限100字。
twitterx false string X/Twitter,上限100字。
facebook false string Facebook,上限100字。
threads false string Threads,上限100字。
telegram false string Telegram,上限100字。
lsmail false string 联系邮箱,上限100字。
profilesubmit true string 值为"yes"。
formhash true string formhash,提交时使用。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
updated int 成功更新的资料项数量。

接口示例

地址:https://www.t00ls.com/myprofile.json

{"status":"success","updated":3}

29. 顶/踩接口

接口功能

对回帖进行顶(赞)或踩(踩)操作

URL

https://www.t00ls.com/dingcai.json

支持格式

JSON

HTTP请求方式

POST(使用Cookie请求)

请求参数

参数 必选 类型 说明
op true string 值为"dingcai"。
pid true int 回帖的帖子ID(pid)。
type true int 1=顶,2=踩。
dingcaisubmit true string 值为"1"。
formhash true string formhash,提交时使用。

返回字段

返回字段 字段类型 说明
status string success:成功;fail:失败。
pid int 回帖ID。
type int 操作类型(1=顶,2=踩)。
ding int 顶的总数。
cai int 踩的总数。
message string 失败原因(self=自己的帖子,already=已操作过,notexists=帖子不存在)。

接口示例

地址:https://www.t00ls.com/dingcai.json

{"status":"success","pid":1239252,"type":1,"ding":1,"cai":0}

30. 表情包接口

接口功能

获取论坛所有可用表情分组(含表情代码和图片路径)

URL

https://www.t00ls.com/smilies.json

支持格式

JSON

HTTP请求方式

GET

请求参数

参数 必选 类型 说明
op true string 值为"smilies"。

返回字段

返回字段 字段类型 说明
status string success:成功。
total int 表情总数。
groups array 表情分组列表。
groups[].name string 分组名称(如"默认表情"、"nonopanda")。
groups[].items array 该分组的表情列表。
groups[].items[].code string 表情代码(发帖时插入此代码)。
groups[].items[].img string 表情图片相对路径。

接口示例

地址:https://www.t00ls.com/smilies.json

{"status":"success","total":149,"groups":[{"name":"默认表情","items":[{"code":"{:7_474:}","img":"images/smilies/default2/xiudou (15).gif"},...]},{"name":"nonopanda","items":[...]},{"name":"兔司黑卡3","items":[...]}]}

31. 文章详情接口

接口功能

获取文章(帖子)详细信息,包含渲染后的正文HTML、附件图片、分类字段

URL

https://www.t00ls.com/articles-{tid}.json

支持格式

JSON

HTTP请求方式

GET(使用Cookie请求)

请求参数

参数 必选 类型 说明
tid true int 文章ID(URL路径参数)。
replies false int 值为"1"时附带评论列表。
page false int 评论页数(默认1,每页10条)。

返回字段

返回字段 字段类型 说明
status string success:成功;fail:失败(含具体message)。
article object 文章详情对象。
article.tid int 文章ID。
article.fid int 版块ID。
article.forumname string 版块名称。
article.subject string 文章标题。
article.author string 作者名。
article.authorid int 作者ID。
article.dateline string 发布时间。
article.views int 阅读次数。
article.replies int 评论次数。
article.digest int 精华级别(0=普通)。
article.message_html string 渲染后的正文HTML。
article.attachments array 附件图片列表(aid/name/url/size/downloads)。
article.sortfields object 分类信息字段(新闻来源/概要等)。
article.isfav int 当前用户是否已收藏(0/1)。
article.links string 文章Web链接。
article.replies_total int 评论总数(仅replies=1时返回)。
article.replies_list array 评论列表(仅replies=1时返回)。

权限说明

与文章页(articles-{tid}.html)完全一致:

  • 隐藏版块组对所有人不可见
  • 帖子display=4(已删除)返回404
  • readperm=244仅管理员可见
  • 阅读权限受限帖需购买记录或为作者
  • 售价帖(price>0)拒绝访问
  • 游客仅限白名单版块+display=1
  • fid=44(漏洞版块)内容隐藏

接口示例

地址:https://www.t00ls.com/articles-75517.json?replies=1

{"status":"success","article":{"tid":75517,"fid":40,"forumname":"安全研究","subject":"...","message_html":"<p>...</p>","attachments":[...],"sortfields":{},"isfav":0,"replies_total":5,"replies_list":[...]}}

32. 悬赏设置正确答案接口

接口功能

悬赏帖作者(或版主)设置某条回帖为正确答案,悬赏TuBi自动转入答主(校验与网页端一致)

URL

https://www.t00ls.com/bestanswer.json

支持格式

JSON

HTTP请求方式

POST

请求参数(使用Cookie请求)

参数 必选 类型 说明
tid true int 悬赏主题ID。
pid true int 要设为正确答案的回帖ID(不能是首帖或自己的回帖)。
bestanswersubmit true string 值为"yes"。
formhash true string formhash,提交时使用。

返回字段

返回字段 字段类型 说明
status string 返回结果状态。success:成功;fail:失败。
tid int 悬赏主题ID。
pid int 被设为正确答案的回帖ID(成功时返回)。
message string 失败时提示:not_reward_thread(非悬赏帖)/ already_solved(已结)/ cant_self(不能选自己)/ post_error(参数错误)/ 无权限等。

接口示例

请求:https://www.t00ls.com/bestanswer.json POST tid=55795&pid=1238896&bestanswersubmit=yes&formhash=xxx

{"status":"success","tid":55795,"pid":1238896}