POST管理接口
创建项目
创建新的项目元数据。
URL
/api/v1/admin/projects鉴权方式
需要管理员 JWT 或 API Key,二者等价(Authorization: Bearer <token>)
请求参数
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
请求体
{
"project_key": "verhub",
"name": "Verhub",
"repo_url": "https://github.com/example/verhub",
"description": "版本与公告管理",
"author": "octocat",
"author_homepage_url": "https://github.com/octocat",
"icon_url": "https://avatars.githubusercontent.com/u/1?v=4",
"website_url": "https://verhub.dev",
"docs_url": "https://docs.verhub.dev",
"published_at": 1760000000
}响应示例
201 响应
{
"id": "verhub",
"project_key": "verhub",
"name": "Verhub",
"description": "版本管理平台",
"repo_url": "https://github.com/example/verhub",
"author": "octocat",
"author_homepage_url": "https://github.com/octocat",
"icon_url": "https://avatars.githubusercontent.com/u/1?v=4",
"website_url": "https://verhub.dev",
"docs_url": "https://docs.verhub.dev",
"published_at": 1760000000,
"optional_update_min_comparable_version": "1.0.0",
"optional_update_max_comparable_version": "1.9.9",
"stats_retention_days": 365,
"aliases": [
"verhub-old"
],
"created_at": 1760000000,
"updated_at": 1760000000
}POST
