Facebook 接口

Facebook 接口

DATA BLUEPRINT 2,031 2023-07-02

接口说明

  • 请求需带上参数token，每个用户有唯一的token。
  • 所有接口均返回json格式，其中参数message表示是否请求成功.
  • 当返回message!="请求成功"时，可以参考返回的message字段,排查错误原因
  • 一般来说，接口只要返回cost=true，就表示请求有效，会进行收费，比如推文不存在，此时请不要再重试了，这种情况一般是请求资源已经失效(404)。
  • Facebook接口请求延时较长，建议timeout设置为30秒，否则可能会出现请求超时但实际请求成功导致账号扣费的场景。

测试token

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

余额查询

http://43.134.116.51:10002/facebook/get_user_balance/?token=
返回如下：
{
    "cost": false,
    "data": {
        "count": 115
    },
    "message": "请求成功"
}

贴文搜索

http://43.134.116.51:10002/facebook/search_post/?token=&keyword=&cursor=&filter_type

token：鉴权参数
keyword：搜索关键词
cursor：翻页参数从上一页返回，默认为空返回第一页数据
filter_type：过滤条件 all：全部 recent_posts：最近, 默认all

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

用户搜索

http://43.134.116.51:10002/facebook/search_user/?token=&keyword=&cursor

token：鉴权参数
keyword：搜索关键词
cursor：翻页参数从上一页返回，默认为空返回第一页数据

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

主页搜索

http://43.134.116.51:10002/facebook/search_page/?token=&keyword=&cursor

token：鉴权参数
keyword：搜索关键词
cursor：翻页参数从上一页返回，默认为空返回第一页数据

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

获取用户信息

http://43.134.116.51:10002/facebook/user_info/?token=&url=

url：用户个人主页或者用户名称或者用户id均可，建议使用用户名称或者id
token：鉴权参数

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

私密用户返回
{
    "cost": true,
    "data": {
        "basic_data": null,
        "fbid": null
    },
    "message": "请求成功"
}

获取用户信息 (新)

http://43.134.116.51:10002/facebook/user_info_new/?token=&entity=

entity：用户个人主页url或者用户名称或者用户id均可，建议使用用户名称或者id
token：鉴权参数

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

用户贴文列表

http://43.134.116.51:10002/facebook/user_post/?token=&fbid=&cursor=&before_time=

token：鉴权参数
fbid：可以从用户信息接口中获取
before_time： 筛选时间 示例：1688480000
cursor：翻页参数从上一页返回，默认为空返回第一页数据

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

用户reel列表

http://43.134.116.51:10002/facebook/user_reel/?token=&fbid=&cursor=&before_time=

token：鉴权参数
fbid：可以从用户信息接口中获取
cursor：翻页参数从上一页返回，默认为空返回第一页数据

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

贴文详情

http://43.134.116.51:10002/facebook/post_detail/?token=&url=

url ：推文详情url

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

粉丝专页的用户贴文

http://43.134.116.51:10002/facebook/user_post_fans/?token=&fbid=&cursor=

token：鉴权参数
fbid：可以从用户信息接口中获取
cursor：翻页参数从上一页返回，默认为空返回第一页数据

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

群组推文

http://43.134.116.51:10002/facebook/user_post_group/?token=&group_id=&cursor=

token：鉴权参数
group_id：群组id
cursor：翻页参数从上一页返回，默认为空返回第一页数据


返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

贴文评论

http://43.134.116.51:10002/facebook/comment/?token=&post_id=&cursor=&sort_type=

token：鉴权参数
post_id：贴文id
cursor：翻页参数从上一页返回，默认为空返回第一页数据
sort_type:排序类型：all：全部  latest：最新  top：最相关

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

贴文二级评论

http://43.134.116.51:10002/facebook/comment/?token=&post_id=&cursor=

token：鉴权参数
post_id：评论id
cursor：翻页参数从上一页返回，默认为空返回第一页数据
expansionToken：从一级评论中获取

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

获取群组信息

http://43.134.116.51:10002/facebook/group_info/?token=&group_name=

group_name：群组名称/群组id
token：鉴权参数

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

获取tag信息

http://43.134.116.51:10002/facebook/tag_info/?token=&tag_name=

tag_name：tag名称
token：鉴权参数

返回如下：
{
     "cost": true,
     "data": {
          ... # fb数据
     },
     "message": "请求成功"
}

常见错误示例

[
     {
          "cost": false,
          "data": {},
          "message": "请求超时,请重试"
     },
     {
          "cost": false,
          "data": {},
          "message": "token验证失败"
     },
     {
          "cost": false,
          "data": {},
          "message": "余额不足"
     },
     {
          "cost": false,
          "data": {},
          "message": "参数错误,请检查参数或者重试"
     },
     {
          "cost": false,
          "data": {},
          "message": "未知错误请联系管理员"
     },
     {
          "cost": false,
          "data": {},
          "message": "** 不能为空"
     }
]