创建平台 · ALBATEXTUS 文档

POST/api/v2/platformsREST

{ }Bodyapplication/json

{
  "name": "示例平台",
  "url": "https://example.com"
}

Request Body

application/json

请求：

{
  "name": "示例平台",
  "url": "https://example.com"
}

请求键	类型	必填	默认/约束
`name`	string	是	去除首尾空白后不能为空。
`url`	string / null	否	省略或 null 保存为 null；作为文本保存，不做网络请求或 URL 有效性核验。

201 响应，同时返回 Location: /api/v2/platforms?id=1：

{
  "id": 1,
  "name": "示例平台",
  "url": "https://example.com"
}

响应的 id 是生成的平台 ID，其他键与请求字段相同，url 总会出现，可能为 null。 GET 单条返回相同结构，GET 列表返回这些对象组成的数组。平台名称不唯一，重复 POST 会创建新平台，不会按名称自动合并。

正文与 JSON 示例读取自 docs/content/athub/API.md，与项目文档保持同源。