# FEED API

动态发布、标签、时间线和动态设置。

> 本文档由 protobuf descriptor 生成。字段名采用 protobuf JSON 名称；64 位整数在 JSON 中应按字符串处理。

## 接入方式

- 动态 HTTP：`POST /rpc/feed/{Service}/{Method}`
- 原生 gRPC：`/feed.{Service}/{Method}`
- grpc-gateway：`POST /feed.{Service}/{Method}`
- 鉴权：需要登录的接口通过 `Authorization: <JWT>` 传递裸 JWT，不添加 `Bearer` 前缀。
- 动态 HTTP 成功或失败均返回 HTTP 200，业务状态见 `code`、`message`、`details`。

## 服务概览

| 服务 | 方法数 | 说明 |
|---|---:|---|
| `Post` | 8 | Post 服务 |
| `Setting` | 2 | Setting 服务 |
| `Tag` | 3 | Tag 服务 |
| `Timeline` | 4 | Timeline 服务 |

## Post

| 方法 | 动态 HTTP 路径 | 请求 | 响应 | 类型 |
|---|---|---|---|---|
| `Fetch` | `POST /rpc/feed/Post/Fetch` | [`blocks.FetchRequest`](#blocksfetchrequest) | [`blocks.FeedPostListReply`](#blocksfeedpostlistreply) | Unary |
| `Create` | `POST /rpc/feed/Post/Create` | [`blocks.FeedPostItem`](#blocksfeedpostitem) | [`blocks.DataStatusReply`](#blocksdatastatusreply) | Unary |
| `Change` | `POST /rpc/feed/Post/Change` | [`blocks.FeedPostItem`](#blocksfeedpostitem) | [`blocks.DataStatusReply`](#blocksdatastatusreply) | Unary |
| `Remove` | `POST /rpc/feed/Post/Remove` | [`blocks.IdentRequest`](#blocksidentrequest) | [`blocks.DataStatusReply`](#blocksdatastatusreply) | Unary |
| `CommentList` | `POST /rpc/feed/Post/CommentList` | [`blocks.FetchRequest`](#blocksfetchrequest) | [`feed.CommentListReply`](#feedcommentlistreply) | Unary |
| `AddComment` | `POST /rpc/feed/Post/AddComment` | [`feed.CommentItem`](#feedcommentitem) | [`blocks.DataStatusReply`](#blocksdatastatusreply) | Unary |
| `DeleteComment` | `POST /rpc/feed/Post/DeleteComment` | [`blocks.IdentRequest`](#blocksidentrequest) | [`blocks.DataStatusReply`](#blocksdatastatusreply) | Unary |
| `Action` | `POST /rpc/feed/Post/Action` | [`feed.PostActionRequest`](#feedpostactionrequest) | [`blocks.DataStatusReply`](#blocksdatastatusreply) | Unary |

### Post.Fetch

- 动态 HTTP：`POST /rpc/feed/Post/Fetch`
- gRPC：`/feed.Post/Fetch`
- 请求示例：

```json
{
  "page_no": "0",
  "page_size": "0",
  "params": {
    "key": "string"
  }
}
```

### Post.Create

- 动态 HTTP：`POST /rpc/feed/Post/Create`
- gRPC：`/feed.Post/Create`
- 请求示例：

```json
{
  "attachs": [
    {
      "attachType": "string",
      "identity": "string",
      "url": "string"
    }
  ],
  "cntComment": "0",
  "cntLike": "0",
  "cntUnlike": "0",
  "content": "string",
  "feedId": "0",
  "feedIdentity": "string",
  "identity": "string",
  "isOpen": false,
  "tags": [
    {
      "content": "string",
      "key": "string"
    }
  ]
}
```

### Post.Change

- 动态 HTTP：`POST /rpc/feed/Post/Change`
- gRPC：`/feed.Post/Change`
- 请求示例：

```json
{
  "attachs": [
    {
      "attachType": "string",
      "identity": "string",
      "url": "string"
    }
  ],
  "cntComment": "0",
  "cntLike": "0",
  "cntUnlike": "0",
  "content": "string",
  "feedId": "0",
  "feedIdentity": "string",
  "identity": "string",
  "isOpen": false,
  "tags": [
    {
      "content": "string",
      "key": "string"
    }
  ]
}
```

### Post.Remove

- 动态 HTTP：`POST /rpc/feed/Post/Remove`
- gRPC：`/feed.Post/Remove`
- 请求示例：

```json
{
  "id": "0",
  "identity": "string"
}
```

### Post.CommentList

- 动态 HTTP：`POST /rpc/feed/Post/CommentList`
- gRPC：`/feed.Post/CommentList`
- 请求示例：

```json
{
  "page_no": "0",
  "page_size": "0",
  "params": {
    "key": "string"
  }
}
```

### Post.AddComment

- 动态 HTTP：`POST /rpc/feed/Post/AddComment`
- gRPC：`/feed.Post/AddComment`
- 请求示例：

```json
{
  "content": "string",
  "feedIdentity": "string",
  "identity": "string",
  "postIdentity": "string",
  "subComment": [
    {}
  ]
}
```

### Post.DeleteComment

- 动态 HTTP：`POST /rpc/feed/Post/DeleteComment`
- gRPC：`/feed.Post/DeleteComment`
- 请求示例：

```json
{
  "id": "0",
  "identity": "string"
}
```

### Post.Action

- 动态 HTTP：`POST /rpc/feed/Post/Action`
- gRPC：`/feed.Post/Action`
- 请求示例：

```json
{
  "actionOp": "string",
  "actionType": "string",
  "identity": "string"
}
```

## Setting

| 方法 | 动态 HTTP 路径 | 请求 | 响应 | 类型 |
|---|---|---|---|---|
| `Info` | `POST /rpc/feed/Setting/Info` | [`blocks.Empty`](#blocksempty) | [`blocks.Empty`](#blocksempty) | Unary |
| `Rights` | `POST /rpc/feed/Setting/Rights` | [`blocks.Empty`](#blocksempty) | [`blocks.Empty`](#blocksempty) | Unary |

### Setting.Info

- 动态 HTTP：`POST /rpc/feed/Setting/Info`
- gRPC：`/feed.Setting/Info`
- 请求示例：

```json
{}
```

### Setting.Rights

- 动态 HTTP：`POST /rpc/feed/Setting/Rights`
- gRPC：`/feed.Setting/Rights`
- 请求示例：

```json
{}
```

## Tag

| 方法 | 动态 HTTP 路径 | 请求 | 响应 | 类型 |
|---|---|---|---|---|
| `List` | `POST /rpc/feed/Tag/List` | [`blocks.FetchRequest`](#blocksfetchrequest) | [`feed.TagListReply`](#feedtaglistreply) | Unary |
| `Create` | `POST /rpc/feed/Tag/Create` | [`feed.AddTagRequest`](#feedaddtagrequest) | [`blocks.DataStatusReply`](#blocksdatastatusreply) | Unary |
| `PostList` | `POST /rpc/feed/Tag/PostList` | [`blocks.FetchRequest`](#blocksfetchrequest) | [`blocks.FeedPostListReply`](#blocksfeedpostlistreply) | Unary |

### Tag.List

- 动态 HTTP：`POST /rpc/feed/Tag/List`
- gRPC：`/feed.Tag/List`
- 请求示例：

```json
{
  "page_no": "0",
  "page_size": "0",
  "params": {
    "key": "string"
  }
}
```

### Tag.Create

- 动态 HTTP：`POST /rpc/feed/Tag/Create`
- gRPC：`/feed.Tag/Create`
- 请求示例：

```json
{
  "tags": [
    "string"
  ]
}
```

### Tag.PostList

- 动态 HTTP：`POST /rpc/feed/Tag/PostList`
- gRPC：`/feed.Tag/PostList`
- 请求示例：

```json
{
  "page_no": "0",
  "page_size": "0",
  "params": {
    "key": "string"
  }
}
```

## Timeline

| 方法 | 动态 HTTP 路径 | 请求 | 响应 | 类型 |
|---|---|---|---|---|
| `Recommend` | `POST /rpc/feed/Timeline/Recommend` | [`blocks.FetchRequest`](#blocksfetchrequest) | [`blocks.FeedPostListReply`](#blocksfeedpostlistreply) | Unary |
| `Friend` | `POST /rpc/feed/Timeline/Friend` | [`blocks.FetchRequest`](#blocksfetchrequest) | [`blocks.FeedPostListReply`](#blocksfeedpostlistreply) | Unary |
| `Follow` | `POST /rpc/feed/Timeline/Follow` | [`blocks.FetchRequest`](#blocksfetchrequest) | [`blocks.FeedPostListReply`](#blocksfeedpostlistreply) | Unary |
| `Hot` | `POST /rpc/feed/Timeline/Hot` | [`blocks.FetchRequest`](#blocksfetchrequest) | [`blocks.FeedPostListReply`](#blocksfeedpostlistreply) | Unary |

### Timeline.Recommend

- 动态 HTTP：`POST /rpc/feed/Timeline/Recommend`
- gRPC：`/feed.Timeline/Recommend`
- 请求示例：

```json
{
  "page_no": "0",
  "page_size": "0",
  "params": {
    "key": "string"
  }
}
```

### Timeline.Friend

- 动态 HTTP：`POST /rpc/feed/Timeline/Friend`
- gRPC：`/feed.Timeline/Friend`
- 请求示例：

```json
{
  "page_no": "0",
  "page_size": "0",
  "params": {
    "key": "string"
  }
}
```

### Timeline.Follow

- 动态 HTTP：`POST /rpc/feed/Timeline/Follow`
- gRPC：`/feed.Timeline/Follow`
- 请求示例：

```json
{
  "page_no": "0",
  "page_size": "0",
  "params": {
    "key": "string"
  }
}
```

### Timeline.Hot

- 动态 HTTP：`POST /rpc/feed/Timeline/Hot`
- gRPC：`/feed.Timeline/Hot`
- 请求示例：

```json
{
  "page_no": "0",
  "page_size": "0",
  "params": {
    "key": "string"
  }
}
```

## 消息结构

### blocks.DataStatusReply

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `data` | `string` | 可选 |
| `timeseq` | `int64` | 可选 |

### blocks.Empty

空消息：请求时发送 `{}`。

### blocks.FeedAttachItem

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `identity` | `string` | 可选 |
| `attachType` | `string` | 可选 |
| `url` | `string` | 可选 |

### blocks.FeedPostItem

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `identity` | `string` | 可选 |
| `content` | `string` | 可选 |
| `feedId` | `int64` | 可选 |
| `feedIdentity` | `string` | 可选 |
| `isOpen` | `bool` | 可选 |
| `cntUnlike` | `int64` | 可选 |
| `cntComment` | `int64` | 可选 |
| `cntLike` | `int64` | 可选 |
| `attachs` | `[]blocks.FeedAttachItem` | 数组 |
| `tags` | `[]blocks.FeedTagItem` | 数组 |

### blocks.FeedPostListReply

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `list` | `[]blocks.FeedPostItem` | 数组 |
| `cnt` | `int64` | 可选 |

### blocks.FeedTagItem

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `key` | `string` | 可选 |
| `content` | `string` | 可选 |

### blocks.FetchRequest

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `page_no` | `int64` | 可选 |
| `page_size` | `int64` | 可选 |
| `params` | `map<string, string>` | 对象映射 |

### blocks.FetchRequest.ParamsEntry

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `key` | `string` | 可选 |
| `value` | `string` | 可选 |

### blocks.IdentRequest

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `id` | `int64` | 可选 |
| `identity` | `string` | 可选 |

### feed.AddTagRequest

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `tags` | `[]string` | 数组 |

### feed.CommentItem

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `identity` | `string` | 可选 |
| `postIdentity` | `string` | 可选 |
| `feedIdentity` | `string` | 可选 |
| `content` | `string` | 可选 |
| `subComment` | `[]feed.CommentItem` | 数组 |

### feed.CommentListReply

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `list` | `[]feed.CommentItem` | 数组 |
| `total` | `int64` | 可选 |

### feed.PostActionRequest

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `actionOp` | `string` | 可选 |
| `actionType` | `string` | 可选 |
| `identity` | `string` | 可选 |

### feed.TagListReply

| JSON 字段 | 类型 | 规则 |
|---|---|---|
| `tags` | `[]blocks.FeedTagItem` | 数组 |
| `total` | `int64` | 可选 |