更新【readme】中的声明 修复【评论区】接口 添加大量【appkey】 添加【客户端信息】接口 添加【纪念账号】相关字段 添加【搜索关注】接口

This commit is contained in:
SocialSisterYi
2021-02-08 00:34:54 +08:00
parent c454b3a409
commit ff24146971
10 changed files with 600 additions and 274 deletions

View File

@@ -2,7 +2,11 @@
<img src="/imgs/comment.svg" width="100" height="100"/>
评论区接口分为**查询**与**操作**两大类
评论系统为全站通用且APP与web端接口共用以type标明对象类型以oid指向响应的对象id
---
**继续查看:**
- [查询类](list.md)
- [操作类](action.md)
@@ -41,24 +45,24 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ |
| rpid | num | 评论rpID | |
| oid | num | 目标评论区rpID | |
| oid | num | 评论区对象id | |
| type | num | 评论区类型代码 | **类型代码见上表** |
| mid | num | 评论发送者UID | |
| mid | num | 发送者UID | |
| root | num | 根评论rpID | 若为一级评论则为0<br />大于一级评论则为根评论ID |
| parent | num | 回复父评论rpID | 若为一级评论则为0<br />若为二级评论则为根评论rpID<br />大于二级评论为上一级评论rpID |
| dialog | num | 回复对方rpID | 若为一级评论则为0<br />若为二级评论则为该评论rpID<br />大于二级评论为上一级评论rpID |
| count | num | 评论回复条数 | |
| rcount | num | 评论回复条数 | |
| floor | num | 评论楼层号 | **重要:若不支持楼层则无此项** |
| count | num | 二级评论条数 | |
| rcount | num | 回复评论条数 | |
| floor | num | 评论楼层号 | **:若不支持楼层则无此项** |
| state | num | 0 | **作用尚不明确** |
| fansgrade | num | 是否具有粉丝标签 | 0无<br />1有 |
| attr | num | | **作用尚不明确** |
| attr | num | 某属性位 | **作用尚不明确** |
| ctime | num | 评论发送时间 | 时间戳 |
| rpid_str | str | 评论rpID | 字串格式 |
| root_str | str | 根评论rpID | 字串格式 |
| parent_str | str | 回复父评论rpID | 字串格式 |
| like | num | 评论获赞数 | |
| action | num | 当前用户操作状态 | 需要登录(SESSDATA) <br />否则恒为0<br />0无<br />1已点赞<br />2已点踩 |
| action | num | 当前用户操作状态 | 需要登录(Cookie或APP) <br />否则恒为0<br />0无<br />1已点赞<br />2已点踩 |
| member | obj | 评论发送者信息 | |
| content | obj | 评论信息 | |
| replies | 无效时null<br />有效时array | 评论回复条目预览 | **仅嵌套一层**<br />否则为null |
@@ -84,9 +88,10 @@
| official_verify | obj | 发送者认证信息 | |
| vip | obj | 发送者会员信息 | |
| fans_detail | 无效时null<br />有效时obj | 发送者粉丝标签 | |
| following | num | 是否关注该用户 | 需要登录(SESSDATA) <br />否则恒为0<br />0未关注<br />1已关注 |
| is_followed | num | 是否被该用户关注 | 需要登录(SESSDATA) <br />否则恒为0<br />0未关注<br />1已关注 |
| following | num | 是否关注该用户 | 需要登录(Cookie或APP) <br />否则恒为0<br />0未关注<br />1已关注 |
| is_followed | num | 是否被该用户关注 | 需要登录(Cookie或APP) <br />否则恒为0<br />0未关注<br />1已关注 |
| user_sailing | obj | 发送者评论条目装扮信息 | |
| is_contractor | bool | 是否为合作用户? | |
`member`中的`level_info`对象:
@@ -120,31 +125,31 @@
`member`中的`official_verify`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ------------------- |
| type | num | 是否认证 | -1无<br />0认证 |
| desc | str | 认证信息 | 无为空 |
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---------------------------------------- |
| type | num | 是否认证 | -1无<br />0个人认证<br />1机构认证 |
| desc | str | 认证信息 | 无为空 |
`member`中的`vip`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | -------------- | ----------------------------------- |
| vipType | num | 大会员类型 | 0无<br />1月会员<br />2年会员 |
| vipDueDate | num | 大会员到期时间 | 毫秒 时间戳 |
| dueRemark | str | 空 | **作用尚不明确** |
| accessStatus | num | 0 | **作用尚不明确** |
| vipStatus | num | 大会员状态 | 0无<br />1有 |
| vipStatusWarn | str | 空 | **作用尚不明确** |
| theme_type | num | 0 | **作用尚不明确** |
| label | obj | | |
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | -------------- | --------------------------------------- |
| vipType | num | 大会员类型 | 0无<br />1月会员<br />2以上会员 |
| vipDueDate | num | 大会员到期时间 | 毫秒 时间戳 |
| dueRemark | str | 空 | **作用尚不明确** |
| accessStatus | num | 0 | **作用尚不明确** |
| vipStatus | num | 大会员状态 | 0无<br />1 |
| vipStatusWarn | str | 空 | **作用尚不明确** |
| theme_type | num | 会员样式id | |
| label | obj | 会员铭牌样式 | |
`vip`中的`label`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ---------------- |
| path | str | 空 | **作用尚不明确** |
| text | str | 会员类型信息 | |
| label_theme | str | 会员类型 | |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ------------------------------------------------------------ |
| path | str | 空 | **作用尚不明确** |
| text | str | 会员类型文案 | |
| label_theme | str | 会员类型 | vip大会员<br />annual_vip年度大会员<br />ten_annual_vip十年大会员<br />hundred_annual_vip百年大会员 |
`member`中的`fans_detail`对象:
@@ -164,7 +169,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ----------------------------- | ------------ | ---------------- |
| pendant | 无效时null<br />有效时obj | 头像框信息 | |
| cardbg | 无效时null<br />有效时obj | 评论条目装扮 | |
| cardbg | 无效时null<br />有效时obj | 评论卡片装扮 | |
| cardbg_with_focus | null | - | **作用尚不明确** |
`user_sailing`中的`pendant`对象:
@@ -200,15 +205,15 @@
`评论条目`中的`content`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | -------------------- | ------------------------------------------------------------ |
| message | str | 评论内容 | **重要** |
| plat | num | 评论发送平台 | 1web端<br />2安卓客户端<br />3ios客户端<br />4wp客户端 |
| device | str | 评论发送平台设备 | |
| members | array | 评论中at到的用户信息 | |
| emote | obj | 表情转义符信息 | 评论内容无表情则无此项 |
| jump_url | obj | | **作用尚不明确** |
| max_line | num | 6 | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------------------ | ------------------------------------------------------------ |
| message | str | 评论内容 | **重要** |
| plat | num | 评论发送 | 1web端<br />2安卓客户端<br />3ios客户端<br />4wp客户端 |
| device | str | 评论发送平台设备 | |
| members | array | at到的用户信息 | |
| emote | obj | 需要渲染的表情转义 | 评论内容无表情则无此项 |
| jump_url | obj | 需要高亮的超链转义 | |
| max_line | num | 6 | 收起最大行数 |
`content`中的`members`数组:
@@ -246,21 +251,40 @@
| size | num | 表情尺寸信息 | 1小<br />2大 |
| alias | str | 简写名 | 无则无此项 |
`content`中的`jump_url`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------- | -------- |
| {超链转义} | obj | 超链转义信息1 | |
| …… | obj | 超链转义信息n | 向下扩展 |
`jump_url`中的`{超链转义}`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ------- | ---- |
| title | str | 标题 | |
| state | num | 图标url | |
| prefixIcon | str | | |
| appUrlSchema | str | | |
| appName | str | | |
| appPackageName | str | | |
| clickReport | str | 上报id | |
`评论条目`中的`replies`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ------------------------------------------------------------ |
| 0 | obj | 回复条目1 | **为本对象的递归嵌套**<br />**仅嵌套一层**<br />按照热度顺序排列 |
| 0 | obj | 回复条目1 | **为本对象的递归嵌套**<br />**仅嵌套一层**<br />按照热度顺序排列 |
| 1 | obj | 回复条目2 | |
| 2 | obj | 回复条目3 | 最后一项 |
`评论条目`中的`folder`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------ | ---------------- |
| has_folded | bool | false | **作用尚不明确** |
| is_folded | bool | false | **作用尚不明确** |
| rule | str | | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------------- | ---- |
| has_folded | bool | 是否有被折叠的二级评论 | |
| is_folded | bool | 评论是否被折叠 | |
| rule | str | 相关规则页面uel | |
`评论条目`中的`up_action`对象: