reddit 接口

reddit 接口

wpchell 134 2022-01-01

接口说明

  • 请确保所有请求均携带有效的token参数(各平台唯一)。

  • 接口统一返回JSON格式数据,重点关注message字段:值为"请求成功"表示成功;其他值请根据其提示排查错误。

  • 当响应中cost=true时,表示请求已生效并计费,即使遇到错误(如资源失效404),也请勿重复尝试。

  • 对于Reddit接口,由于其响应时间较长,强烈建议设置超时(timeout)不少于30秒,以避免因超时误判导致重复请求扣费。​

测试token

token: 请联系管理员开通 q:1098441010 vx:pchell11

余额查询

请求示例
http://43.134.116.51:10002/reddit/get_user_balance/?token=
参数

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

响应
{
    "cost": false,
    "data": {
        "count": 9999.0
    },
    "message": "请求成功"
}
其他说明

用户信息

请求示例
http://43.134.116.51:10002/reddit/user_info/?token=&user_name=
参数

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

user_name

用户名

用户名,示例:https://www.reddit.com/user/Lord-Zippy/ 取用户名:Lord-Zippy

响应
{
     "cost": true,
     "data": {
          ... # reddit数据
     },
     "message": "请求成功"
}
其他说明

社区信息

请求示例
http://43.134.116.51:10002/reddit/community_info/?token=&community_name=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

community_name

社区名

https://www.reddit.com/r/marioandluigi/取社区名:marioandluigi

响应
{
     "cost": true,
     "data": {
          ... # reddit数据
     },
     "message": "请求成功"
}
其他说明

按照发布时间排序

搜索

请求示例
http://43.134.116.51:10002/reddit/search/?token=&keyword=&search_type=&sort_type=&t=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

keyword

搜索关键词

-

search_type

搜索类型

posts,communities,comments,media,people

posts

sort_type

排序方式

hot: 热门 relevance:综合 new:最新

relevance

t

过滤时间

null:所有时间

year:过去一年

month:过去一个月

week:过去一周

day:过去24小时

hour:过去一小时

null

cursor

翻页参数

从上一页获取after

空,返回第一页数据

响应
{
     "cost": true,
     "data": {
          ... # reddit数据
     },
     "message": "请求成功"
}
其他说明

搜索(按指定社区搜索)

请求示例
http://43.134.116.51:10002/reddit/search_in_community/?token=&keyword=&community_name=&search_type=&sort_type=&t=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

keyword

搜索关键词

-

community_name

社区名

https://www.reddit.com/r/marioandluigi/取社区名:marioandluigi

search_type

搜索类型

posts,communities,comments,media,people

posts

sort_type

排序方式

hot: 热门 relevance:综合 new:最新

relevance

t

过滤时间

null:所有时间

year:过去一年

month:过去一个月

week:过去一周

day:过去24小时

hour:过去一小时

null

cursor

翻页参数

从上一页获取after

空,返回第一页数据

响应
{
     "cost": true,
     "data": {
          ... # reddit数据
     },
     "message": "请求成功"
}
其他说明

搜索(按指定用户搜索)

请求示例
http://43.134.116.51:10002/reddit/search_in_user/?token=&keyword=&community_name=&search_type=&sort_type=&t=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

keyword

搜索关键词

-

user_name

用户名

用户名,示例:https://www.reddit.com/user/Lord-Zippy/ 取用户名:Lord-Zippy

search_type

搜索类型

posts,communities,comments,media,people

posts

sort_type

排序方式

hot: 热门 relevance:综合 new:最新

relevance

t

过滤时间

null:所有时间

year:过去一年

month:过去一个月

week:过去一周

day:过去24小时

hour:过去一小时

null

cursor

翻页参数

从上一页获取after

空,返回第一页数据

响应
{
     "cost": true,
     "data": {
          ... # reddit数据
     },
     "message": "请求成功"
}
其他说明

贴文评论(包含回复)

请求示例
http://43.134.116.51:10002/reddit/comment/?token=&post_id=&sort_type=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

post_id

贴文id

https://www.reddit.com/r/OnePiece/comments/1bl7wjl/one_piece_chapter_1111 取1bl7wjl

sort_type

排序方式

hot: 热门 relevance:综合 new:最新

new

cursor

翻页参数

从上一页获取after

空,返回第一页数据

响应
{
     "cost": true,
     "data": {
          ... # reddit数据
     },
     "message": "请求成功"
}
其他说明

用户贴文列表

请求示例
http://43.134.116.51:10002/reddit/user_post/?token=&user_name=&sort_type=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

user_name

用户名

https://www.reddit.com/user/Lord-Zippy/ 取用户名:Lord-Zippy

sort_type

排序方式

hot: 热门 new:最新

new

cursor

翻页参数

从上一页获取after

空,返回第一页数据

响应
{
     "cost": true,
     "data": {
          ... # reddit数据
     },
     "message": "请求成功"
}
其他说明

社区贴文列表

请求示例
http://43.134.116.51:10002/reddit/community_post/?token=&community_name=&sort_type=&cursor=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

community_name

社区名

https://www.reddit.com/r/marioandluigi/取社区名:marioandluigi

sort_type

排序方式

hot: 热门 new:最新

new

cursor

翻页参数

从上一页获取after

空,返回第一页数据

响应
{
     "cost": true,
     "data": {
          ... # reddit数据
     },
     "message": "请求成功"
}
其他说明

贴文详情

请求示例
http://43.134.116.51:10002/reddit/post_detail/?token=&detail_url=
参数说明

参数名

含义

传参说明

是否必须

缺省值

token

鉴权参数

-

detail_url

贴文链接

-

响应
{
     "cost": true,
     "data": {
          ... # reddit数据
     },
     "message": "请求成功"
}
其他说明

如果是使用国内服务器调用API接口建议使用post请求,贴文url由于带reddit.com的域名在国内访问可能会被运营商直接拦截,curl请求示例如下:

curl --location 'http://43.134.116.51:10002/reddit/post_detail/?token=***' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'detail_url=***'