社交
关注、私信和频道相关接口。
关注
POST
/api/trpc/follow.follow需登录social:write| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userId | string | 是 | 目标用户 ID |
POST
/api/trpc/follow.unfollow需登录social:write| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userId | string | 是 | 目标用户 ID |
POST
/api/trpc/follow.isFollowing需登录social:read| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userId | string | 是 | 目标用户 ID |
粉丝 / 关注列表
POST
/api/trpc/follow.followers公开| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userId | string | 是 | 用户 ID |
cursor | string | 否 | 分页游标 |
limit | number | 否 | 每页数量 |
POST
/api/trpc/follow.following公开| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userId | string | 是 | 用户 ID |
cursor | string | 否 | 分页游标 |
limit | number | 否 | 每页数量 |
POST
/api/trpc/follow.counts公开| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userId | string | 是 | 用户 ID |
私信
会话列表
POST
/api/trpc/message.conversations需登录social:read| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
cursor | string | 否 | 分页游标 |
limit | number | 否 | 每页数量 |
获取或创建会话
POST
/api/trpc/message.getOrCreate需登录social:write| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
userId | string | 是 | 目标用户 ID |
获取消息列表
POST
/api/trpc/message.messages需登录social:read| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
conversationId | string | 是 | 会话 ID |
cursor | string | 否 | 分页游标 |
limit | number | 否 | 每页数量 |
发送消息
POST
/api/trpc/message.send需登录social:write| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
conversationId | string | 是 | 会话 ID |
content | string | 否 | 消息内容 |
type | string | 否 | 消息类型：TEXT / IMAGE / FILE / STICKER |
metadata | object | 否 | 附加数据 |
频道
频道列表
POST
/api/trpc/channel.list公开| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
cursor | string | 否 | 分页游标 |
limit | number | 否 | 每页数量 |
按 slug 获取频道
POST
/api/trpc/channel.getBySlug公开| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
slug | string | 是 | 频道 slug |
创建频道
POST
/api/trpc/channel.create需登录social:write| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 是 | 频道名称 |
slug | string | 是 | 频道 slug（URL 标识） |
description | string | 否 | 描述 |
type | string | 否 | 类型：PUBLIC / PRIVATE |
加入 / 离开频道
POST
/api/trpc/channel.join需登录social:write| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
channelId | string | 是 | 频道 ID |
POST
/api/trpc/channel.leave需登录social:write| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
channelId | string | 是 | 频道 ID |
发送频道消息
POST
/api/trpc/channel.send需登录social:write| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
channelId | string | 是 | 频道 ID |
content | string | 否 | 消息内容 |
type | string | 否 | 消息类型 |
replyToId | string | 否 | 回复的消息 ID |