本地圈接口

获取本地圈列表

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/list

参数列表

@param string $ids          本地圈id，多个以英文,分隔 默认空
@param int $start_time   开始时间 默认0
@param int $end_time     结束时间 默认0
@param string $user_ids  用户id，多个以英文,分隔 默认空
@param string $tag_ids   话题id，多个以,分隔 默认空
@param int $side_type    本地圈类型  0 全部 1 纯文字 2带图片 3 小视频
@param int $show_tag_mark  内容中话题是否用[tag_id]显示  默认0  1显示
@param int $limit        限制条数 默认20条
@param int $page         页数，从0页开始 默认0
@param int $order          0发布时间倒序 1发布时间正序 2赞同倒序 3最后回复时间倒序 4更新时间倒序 5回复数量倒序  默认0
@param int $is_hot        是否在热门列表  0  默认所有   1选择热门列表的

返回值

ret
text
data  array
    side  object
        id                //本地圈id 
        url                //分享url
        user_id            //发布人id
        username        //发布人
        content            //发布内容
        status            //状态 0待审 1通过 2不通过 3异常 4用户删除
        has_filter        //是否含有敏感词
        attach_num        //附件数
        reply_num       //回复数
        view_num        //查看数
        like_num        //点赞数
        last_reply_time //最新回复时间
        longitude       //经度
        latitude        //维度
        address         //发布地址
        created_at      //发布时间
        updated_at      //更新时间
        attach_id       //封面的附件id
        attaches  array   //本地圈附件
            id        //附件id
            width     //宽度
            height    //高度
            url       //附件链接
        likes   array  //点赞的
            user_id    //用户id
            username   //用户名

本地圈数量

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/count

参数列表

  @param int $start_time   开始时间 默认0
  @param int $end_time     结束时间 默认0
  @param string $user_ids  用户id，多个以英文,分隔  默认空

###返回值
ret
text
data object
side_count //本地圈数量

本地圈回复列表

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/reply-list

参数列表

 @param int $side_id     本地圈id 默认0
 @param int $user_id     用户id   默认0
 @param int $start_time  开始时间 默认0
 @param int $end_time    结束时间 默认0
 @param int $limit       限制条数 默认20条
 @param int $page        页数，从0页开始 默认0
 @param int $order       0发布时间倒序 1发布时间正序  默认0

返回值

ret
text
data  array
    reply  object
        id                //本地圈id 
        url                //分享url
        user_id            //发布人id
        username        //发布人
        reply_id        //引用回复的id
        reply_user_id   //引用回复的用户id
        reply_username  //引用回复的用户名
        content            //发布内容
        status            //状态 0待审 1通过 2不通过 3异常 4用户删除
        has_filter        //是否含有敏感词
        created_at      //发布时间

本地圈回复数

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/reply-count

参数列表

 @param int $side_id      本地圈id  默认0
 @param int $user_id      用户id    默认0
 @param int $start_time   开始时间戳 默认0
 @param int $start_time   开始时间戳 默认0

###返回值
ret
text
data object
reply_count //当前本地圈回复数量

批量给本地圈点赞

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/add-side-like

参数列表

 @param string $side_ids            本地圈id  逗号分隔
 @param string $user_ids            用户id（马甲）  逗号分隔

返回值

ret  成功返回0
text 错误说明
data array
        side_id  like_num         本地圈对应的点赞数

发布本地圈

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/add-side-info   

参数列表

 @param int $user_id            用户id  必要 
 @param string $content           内容   必须
 @param string $content            内容  必须
 @param array(json格式)  attaches               附件数组
                  url     string    地址
                  w    int        宽
                  h    int        高
@param object(json格式)  video               小视频参数
                  url     string    地址
                  w    int        宽
                  h    int        高
                  time_length int     时长（ms）
 @param int $tag_id            话题id
 @param string $longitude       经度
 @param string $latitude        纬度
 @param string $address        地址

注：参数必须放到示例中post_data里面

返回值

ret            int            错误代码        0：成功    1：失败
text        string        错误内容
    data    array        返回信息
    id            int        身边id
    share_url     string  分享url

对特定本地圈帖子添加回复

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/add-side-reply  

参数列表

 @param string $side_id            本地圈id 
 @param string $user_id            用户id
 @param string $content            内容

注：参数必须放到示例中post_data里面

返回值

ret  成功返回0
text 错误说明
data array
        id  reply_id   添加成功的reply_id

获取所有话题接口

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/get-topics

参数列表

@param int $recommend    是否推荐   0所有  1只推荐的

###返回值
ret 成功返回0
text 错误说明
data array
id 话题id
name 话题名称
icon 话题图标
banner 横图
follow 关注人数
side_num 话题下本地圈数量
join_num 话题参与人数
img_num 图片数量

获取时间区间内指定话题点赞统计接口，按照获赞次数倒序排序

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/get-topic-data

参数列表

@param string $topic_id      话题id
@param int    $start  开始时间
@param int  $end  结束时间

返回值

ret  成功返回0
text 错误说明
data array
        user_id     用户id
        username    用户名
        side_count  话题图标
        like_count  获赞次数
        user_count  获赞人数

根据话题获取本地圈列表

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/list-by-taguid

参数列表

@param int $tag_id       话题id
@param int $user_id   用户id 默认空
@param int $limit     分页大小 默认10
@param int $page      页数 默认1

返回值

ret
text
data  array
    side  object
        id                //本地圈id 
        url                //分享url
        user_id            //发布人id
        username        //发布人
        content            //发布内容
        status            //状态 0待审 1通过 2不通过 3异常 4用户删除
        has_filter        //是否含有敏感词
        attach_num        //附件数
        reply_num       //回复数
        view_num        //查看数
        like_num        //点赞数
        last_reply_time //最新回复时间
        longitude       //经度
        latitude        //维度
        address         //发布地址
        created_at      //发布时间
        updated_at      //更新时间
        attaches  array   //本地圈附件
            width     //宽度
            height    //高度
            url       //附件链接
        likes   array  //点赞的
            user_id    //用户id
            username   //用户名

不通过本地圈或 本地圈 评论

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/verify-side-api

参数列表

@param         int  $type            操作类型（1：本地圈 2：本地圈评论）
@param         int  $$side_id         圈子id
@param         int  $reply_id      回复id
@param         int  $uid     用户id

返回值

ret        //成功 0，错误 1
text    //提示消息
data   string

创建话题接口

###接口地址
http://{hostname}.qianfanapi.com/api1_2/side/add-topic

参数列表

@param         string  $name            话题名称
@param         string  $user_id      用户id
@param         string  $introduce    话题描述

返回值

ret        //成功 0，错误 1
text    //提示消息
data  array
    tag_id    int        //话题id

##用户取消关注话题接口
不可对话题的创建者进行该操作

###接口地址
http://{hostname}.qianfanapi.com/api1_2/side/remove-collect

###参数列表
@param int $user_id 用户id
@param int $tag_id 话题id

###返回值
ret //成功 0，错误 1
text //提示消息
data

本地圈移除话题接口

• 只有话题的发起者才有权限进行该操作
• 将本地圈移除话题，话题的参与者数量不会减少

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/remove-side

参数列表

@param         int  $user_id      执行用户id
@param         int  $tag_id       话题id
@param         int  $side_id      本地圈id

返回值

ret        //成功 0，错误 1
text    //提示消息
data  

本地圈用户指定时间内点赞查询接口

接口地址

http://{hostname}.qianfanapi.com/api1_2/side/like-count

参数列表

@param         int  $uid      用户id （多个用户用英文,连接）
@param         int  $start_at    开始时间（默认今天开始时间）
@param         int  $end_at    结束时间（默认明天开始时间）

返回值

ret        //成功 0，错误 1
text    //提示消息
data  array
    uid(用户id）=& num（点赞数）