PUT管理接口

更新实例级 GitHub App 配置

部分更新:只修改请求中出现的字段。`private_key` / `webhook_secret` 传空字符串表示清除。 私钥以 AES-256-GCM 加密落库,密钥派生自实例的 JWT_SECRET。 各功能所需的 GitHub App 权限: - `feedback_issue`(反馈转发 Issue):Repository permissions → Issues: Read and write - `comment_commands`(评论命令触发工作流):Repository permissions → Actions: Read and write, 并在 App 设置中订阅 Issue comment 事件、配置 Webhook URL 与 secret

URL

/api/v1/admin/github-app

鉴权方式

需要管理员 JWT(Authorization: Bearer <token>)

请求参数

Header 参数

名称类型必填说明
AuthorizationstringBearer <管理员 JWT 或 API Key>

请求体

{
  "app_id": "123456",
  "private_key": "-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----",
  "enabled_features": [
    "feedback_issue",
    "comment_commands"
  ]
}

响应示例

200 响应

{
  "configured": true,
  "app_id": "123456",
  "has_private_key": true,
  "private_key_fingerprint": "8f4e2a1b9c0d7e6f",
  "private_key_updated_at": 1760000000,
  "has_webhook_secret": true,
  "webhook_secret_hint": "4mx9k2",
  "webhook_secret_length": 32,
  "webhook_secret_updated_at": 1760000000,
  "webhook_payload_path": "/api/v1/webhooks/github-app",
  "enabled_features": [
    "feedback_issue"
  ],
  "feedback_issue_custom_template": false,
  "feedback_issue_title_template": null,
  "feedback_issue_body_template": null,
  "builtin_feedback_issue_title_template": "[用户反馈] {{content_head}}",
  "builtin_feedback_issue_body_template": "## 反馈内容\n\n{{content}}\n",
  "feedback_issue_template_variables": [
    "project_key",
    "content",
    "contact"
  ],
  "updated_at": 1760000000
}
PUT

Try It Out

请求 URL 预览

/api/v1/admin/github-app