创建连接
POST
/web/v1/workspaces/{workspaceId}/slash/connectionsJWT在指定工作区内创建新的 Slash 平台连接。
鉴权
需要具有 workspace:manage 权限的有效 JWT token。Portal 访问权限:system、tenant。
请求参数
| Name | Type | Required | In | Description |
|---|---|---|---|---|
workspaceId | String | Yes | path | 工作区 ID。 |
connectionName | String | Yes | body | 连接显示名称。 |
partnerEndpoint | String | Yes | body | 合作方 API 端点 URL。 |
slashApiBaseUrl | String | Yes | body | Slash 平台 API 基础 URL。 |
slashApiKey | String | Yes | body | 用于 Slash 认证的 API Key。 |
slashAccountId | String | Yes | body | Slash 账户标识符。 |
slashWebhookSecret | String | Yes | body | 用于签名验证的 Webhook 密钥。 |
tenantBizId | String | No | body | 租户业务 ID。若省略则自动解析。 |
成功响应
Bad Request400
{
"code": "4000",
"message": "connectionName must not be blank"
}错误响应
| HTTP 状态码 | 错误码 | 描述 |
|---|---|---|
| 400 | 4000 | 校验错误(缺少必填字段) |
| 401 | 4010 | 无效或过期的 JWT token |
| 403 | 4030 | 权限不足 |
说明
- 成功时返回 HTTP 201。
- 敏感字段(
slashApiKey、slashAccountId、slashWebhookSecret)在响应中已脱敏。 - 连接以
PENDING状态 (20010201) 创建。