Skip to content

Commit 48ad1e1

Browse files
authored
Update community.md (#174)
* Update community.md * Update community.md
1 parent 5576d9b commit 48ad1e1

1 file changed

Lines changed: 180 additions & 0 deletions

File tree

src/api/v1/community.md

Lines changed: 180 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -726,3 +726,183 @@ POST /v1/community/black-list
726726
"msg": "success" // 返回消息
727727
}
728728
```
729+
730+
## 查看文章详情
731+
732+
POST /v1/community/posts/post-detail
733+
734+
请求头:
735+
736+
|名称|必须|备注|
737+
|-----|-----|-----|
738+
|token|||
739+
740+
请求体:
741+
```JSONC
742+
{
743+
"id": 31622 //文章id
744+
}
745+
```
746+
747+
响应体:
748+
```JSONC
749+
{
750+
"code": 1, // 请求状态码,1为正常
751+
"data": {
752+
"ba": {
753+
"id": 41, // 文章分区id
754+
"name": "云湖", // 分区名称
755+
"avatar": "https://chat-img2.jwznb.com/FoHHKnX-QNuD33-NnGWlq74xkgpg.webp", // 作者头像url
756+
"delTime":url // 删除时间(戳)
757+
"createTime": 1665233353, // 文章创建时间戳
758+
"lastActive": 1757794419, // 上次活跃时间戳
759+
"memberNum": 1118, // 该分区订阅的人数
760+
"postNum": 9752, // 该分区的文章数量
761+
"groupNum": 64, // 该分区绑定的群聊数量
762+
"createTimeText": "2022-10-08 20:49:13", // 分区创建时间
763+
"isFollowed": "0"
764+
},
765+
"isAdmin": 0, // 文章作者是否为管理员
766+
"post": {
767+
"id": 31622, // 文章id
768+
"baId": 41, // 该文章所处的分区id
769+
"senderId": "7384288", // 文章作者id
770+
"senderNicknameId": 185792, // 文章作者名称id
771+
"senderAvatarId": 46626, // 文章作者头像id
772+
"groupId": "", // 该文章所处的群聊id
773+
"title": "文章标题", // 文章标题
774+
"contentType": 2, // 文章类型,1-普通文字,2-Markdown
775+
"content": "文章内容", // 文章内容
776+
"delTime": 0, // 删除时间(戳)
777+
"createTime": 1757755754, // 文章发送时间戳
778+
"updateTime": 0, // 文章更新时间戳
779+
"editTime": 1757755828, // 文章上次编辑时间戳
780+
"lastActive": 1757755828, // 文章上次活跃(编辑)时间戳
781+
"likeNum": 0, // 文章点赞数量
782+
"commentNum": 0, // 文章评论数量
783+
"collectNum": 0, // 文章收藏数量
784+
"amountNum": 0, // 文章投币数量
785+
"senderNickname": "作者名称", // 文章作者名称
786+
"senderAvatar": "https://chat-img.jwznb.com/14ee9ecc8856e34e9f3fdd115e5139b6.jpg", // 文章作者头像url
787+
"createTimeText": "2025-09-13 17:29:14", // 文章发送时间
788+
"group": { // 该文章下绑定的群聊信息
789+
"id": 0, // 会话类型id
790+
"groupId": "", // 群聊id
791+
"name": "", // 群聊名称
792+
"introduction": "", // 群聊简介
793+
"createBy": "", // 该群群主id
794+
"createTime": 0, // 群聊创建时间戳
795+
"avatarId": 0, // 群头像id
796+
"del_flag": 0,
797+
"avatarUrl": "", // 群头像url
798+
"headcount": 0, // 群聊人数
799+
"readHistory": 0, // 是否开启群聊历史消息选项,0-关,1-开
800+
"alwaysAgree": 0, // 是否总是默认新成员进群选项,0-关,1-开
801+
"categoryId": 0, // 群聊类型id
802+
"category": "", // 群聊类型
803+
"private": 0, // 是否私有选项,0-关,1-开
804+
"banId": 0, // 被ban的id
805+
"gag": 0, // 被禁言群成员id
806+
"gagBy": "", // 谁禁言的成员id
807+
"msgTypeLimit": "" // 群聊消息类型限制
808+
},
809+
"ba": { // 分区相关信息
810+
"id": 41, // 该文章所属分区id
811+
"name": "云湖", // 分区名称
812+
"avatar": "https://chat-img.jwznb.com/1665235278282.2976yunhu192.png", // 分区头像url
813+
"delTime": 0, // 分区删除时间戳
814+
"createTime": 1665233353, // 分区创建时间戳
815+
"lastActive": 1757794419, // 分区上次活跃时间戳
816+
"memberNum": 1118, // 分区成员数量
817+
"postNum": 9752, // 分区文章数量
818+
"groupNum": 64 // 该分区下绑定的群聊数量
819+
},
820+
"isLiked": 0, // (你)是否给文章点赞,0-没有,1-点了
821+
"isCollected": 0, // (你)是否收藏该文章,0-没有,1-收了
822+
"isReward": 0, // (你)是否给文章投币,0-没有,1-投了
823+
"isVip": 0 // 文章作者是否为vip,0-没有,1-有
824+
}
825+
},
826+
"msg": "success" // 返回消息
827+
}
828+
```
829+
830+
## 查看自己发布的文章
831+
832+
POST /v1/community/posts/my-post-list
833+
834+
请求头:
835+
836+
|名称|必须|备注|
837+
|-----|-----|-----|
838+
|token|||
839+
840+
请求体:
841+
842+
```JSONC
843+
{
844+
"size": 20, // 显示文章数量
845+
"page": 1 // 页数
846+
}
847+
```
848+
849+
响应体:
850+
```JSONC
851+
{
852+
"code": 1, // 请求状态码,1为正常
853+
"data": {
854+
"posts": [ // 帖子相关
855+
{
856+
"id": 31635, // 文章id
857+
"baId": 49, // 文章所属分区id
858+
"senderId": "1659829", // 文章作者
859+
"senderNicknameId": 177154, // 作者名称id
860+
"senderAvatarId": 46580, // 作者头像id
861+
"groupId": "", // 文章所属群聊id
862+
"title": "test", // 文章标题
863+
"contentType": 1, // 文章类型,1-普通文字,2-Markdown
864+
"content": "内容", // 文章内容
865+
"delTime": 0, // 删除时间
866+
"createTime": 1757818078, // 文章发布时间戳
867+
"updateTime": 0, // 文章更新时间戳
868+
"editTime": 0, // 文章编辑时间戳
869+
"lastActive": 1757818078, // 文章上次活跃时间
870+
"likeNum": 0, // 文章赞数
871+
"commentNum": 0, // 文章评论数量
872+
"collectNum": 0, // 文章收藏数量
873+
"amountNum": 0, // 文章投币数量
874+
"senderNickname": "作者", // 文章作者名称
875+
"senderAvatar": "https://chat-img.jwznb.com/aa117e6f7a237926ea75426fd707f915.jpg", // 文章作者头像url
876+
"createTimeText": "2025-09-14 10:47:58", // 文章发布时间
877+
"group": { // 文章绑定群聊相关
878+
"id": 0, // 文章所属群聊的类型id
879+
"groupId": "", // 文章所属群聊id
880+
"name": "", // 群聊名称
881+
"introduction": "", // 群聊简介
882+
"createBy": "", // 群聊群主id
883+
"createTime": 0, // 群聊创建时间戳
884+
"avatarId": 0, // 群聊头像id
885+
"del_flag": 0,
886+
"avatarUrl": "", // 群聊头像url
887+
"headcount": 0, // 群聊人数
888+
"readHistory": 0, // 是否开启聊天历史记录,0-没有,1-开了
889+
"alwaysAgree": 0, // 新成员是否直接进入群聊,0-没有,1-开了
890+
"categoryId": 0, // 群聊类型id
891+
"category": "", // 群聊类型
892+
"private": 0, // 群聊是否私有,0-没有,1-开了
893+
"banId": 0, // 被banid
894+
"gag": 0, // 被禁言者id
895+
"gagBy": "", // 禁言者id
896+
"msgTypeLimit": "" // 消息类型限制
897+
},
898+
"isLiked": "0", // (你)是否点赞该文章,0-没有,1-点了
899+
"isCollected": 0, // (你)是否收藏该文章,0-没有,1-点了
900+
"isReward": 0, // (你)是否投币该文章,0-没有,1-点了
901+
"isVip": 0 // 暂时不清楚
902+
}
903+
],
904+
"total": 1 // 文章数量
905+
},
906+
"msg": "success" // 返回成功消息
907+
}
908+
```

0 commit comments

Comments
 (0)