# 创建讨论

`POST` `/v1/content/topics`

在 [社区](https://longbridge.com/topics) 创建一篇新讨论。支持两种内容类型：

| 类型 | `title` | `body` 格式 | 说明 |
|------|---------|-------------|------|
| `post`（默认） | 可选 | 纯文本 | Markdown 语法（如 `**加粗**`、`# 标题`）**不会渲染**，将作为字面字符显示，类似发推文。 |
| `article` | **必填** | Markdown | 服务端将 Markdown 转为 HTML 展示，支持标题、表格、加粗、代码块等。 |

仅限 **Longbridge 开户且持有资产** 的用户才允许通过 Longbridge Developers 的 API 或 CLI 发布社区讨论和回复。否则返回 `403`。

:::tip Tip
正文中提到的标的代码（如 `700.HK`、`TSLA.US`）会被平台自动识别并关联为相关标的。`tickers` 字段用于补充正文中未显式提及的标的。

⚠️ 请勿滥用此功能关联与内容无关的标的，否则后台内容运营可能会限制发布，甚至有可能禁言。
:::

**频率限制：** 同一用户每分钟最多创建 3 篇，24 小时内最多 10 篇，超出返回 `429`。

:::warning
⚠️ 以上频率限制规则仅供参考，平台可能随时进行内部调整。
:::

## Parameters

### Request Body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | No | 标题。`topic_type` 为 `article` 时必填，`post` 时可省略。 |
| `body` | string | Yes | 正文。`post` 类型为纯文本，Markdown 不渲染；`article` 类型支持 Markdown。 |
| `topic_type` | string | No | 内容类型：`post`（纯文本，默认）或 `article`（Markdown） |
| `tickers` | array | No | 关联标的代码，格式 `{symbol}.{market}`，如 `["AAPL.US", "700.HK"]`，最多 10 个。**注意：** 正文中提到的标的代码（如 `700.HK`、`TSLA.US`）会被平台自动识别并关联，`tickers` 用于补充正文中未显式提及的标的。 |
| `hashtags` | array | No | 讨论标签名称列表，如 `["earnings", "fed"]`，最多 1 个 |

## Request Example

```bash
curl --request POST \
  --url 'https://openapi.longbridge.com/v1/content/topics' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{"title":"<title>","body":"<body>","topic_type":"<topic_type>","tickers":[],"hashtags":[]}'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `item` | object | Yes | 新建讨论详情 |
| `└ id` | string | Yes | 讨论 ID |
| `└ title` | string | No | 标题 |
| `└ description` | string | No | 纯文本摘要（由正文自动截取） |
| `└ body` | string | No | 完整正文（`article` 类型为 Markdown） |
| `└ topic_type` | string | No | 内容类型，`article` 或 `post` |
| `└ tickers` | string[] | No | 关联标的代码 |
| `└ hashtags` | string[] | No | 讨论标签名称列表 |
| `└ images` | object[] | No | 附图列表 |
| `└ ∟ url` | string | No | 原始图片 URL |
| `└ ∟ sm` | string | No | 小缩略图 URL |
| `└ ∟ lg` | string | No | 大缩略图 URL |
| `└ likes_count` | int32 | No | 点赞数 |
| `└ comments_count` | int32 | No | 回复数 |
| `└ views_count` | int32 | No | 浏览数 |
| `└ shares_count` | int32 | No | 分享数 |
| `└ detail_url` | string | No | 讨论页面直链 |
| `└ author` | object | No | 作者信息 |
| `└ ∟ member_id` | string | No | 作者 member ID |
| `└ ∟ name` | string | No | 作者昵称 |
| `└ ∟ avatar` | string | No | 作者头像 URL |
| `└ created_at` | string | Yes | 创建时间，Unix 时间戳（秒） |
| `└ updated_at` | string | No | 最近更新时间，Unix 时间戳（秒） |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "item": {
      "id": "39304657",
      "title": "My View on AAPL",
      "topic_type": "article",
      "tickers": [
        "AAPL.US"
      ],
      "hashtags": [
        "earnings"
      ],
      "created_at": "1742000000"
    }
  }
}
```
