POST管理接口
后台手动新增日志
后台补录一条日志。与客户端上报端点不同：不做重复抑制，也不写入 ip / user_agent / 地理位置等来源字段，platform 与 platform_version 由请求体显式指定。
URL
/api/v1/admin/projects/{projectKey}/logs鉴权方式
需要管理员 JWT 或 API Key，二者等价（Authorization: Bearer <token>）
请求参数
Path 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| projectKey | string | 是 | 项目主键 project_key（大小写不敏感） |
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
请求体
{
"level": 2,
"content": "定时任务执行失败，已人工恢复。",
"platform": "windows",
"platform_version": "11"
}响应示例
201 创建成功
{
"id": "log-001",
"level": 2,
"content": "更新检查请求超时，已重试。",
"device_info": {
"os": "Windows 11",
"arch": "x64"
},
"custom_data": {
"app_version": "1.2.0"
},
"is_hidden": false,
"ip": "203.0.113.9",
"user_agent": "verhub-sdk/1.0",
"country_code": "CN",
"country_name": "中国",
"region_name": "广东省",
"city": "深圳",
"platform": "windows",
"created_at": 1760000000
}POST