Skip to content

组织集成 API

在组织级别管理集成配置(SMTP、Jira 等),工作空间和项目自动继承。

列出集成

http
GET /api/v1/organizations/{org_id}/integrations
Authorization: Bearer <token>

获取集成详情

当前版本请通过“列出集成”接口返回的数据查看详情。

创建/更新集成

需要 admin 角色。

http
POST /api/v1/organizations/{org_id}/integrations
Authorization: Bearer <token>
Content-Type: application/json

{
  "integration_type": "smtp",
  "config": {
    "host": "smtp.example.com",
    "port": 587,
    "username": "noreply@example.com",
    "password": "secret",
    "from_email": "noreply@example.com"
  },
  "enabled": true
}

测试集成

http
POST /api/v1/organizations/{org_id}/integrations/{type}/test
Authorization: Bearer <token>

删除集成

http
DELETE /api/v1/organizations/{org_id}/integrations/{type}
Authorization: Bearer <token>

支持的类型示例:smtpjiragithubgit

配置解析顺序

集成配置按以下顺序解析(优先级从高到低):

  1. 项目级配置
  2. 工作空间级配置
  3. 组织级配置
  4. 全局默认配置

Forgexa — AI 软件工厂