Skip to content

创建连接

POST/web/v1/workspaces/{workspaceId}/slash/connections JWT

在指定工作空间内创建一个新的 Slash 平台连接。

鉴权

需要有效的 JWT token 并具有 workspace:manage 权限。Portal 访问权限:systemtenant

请求参数

NameTypeRequiredInDescription
workspaceIdStringRequiredpath工作空间 ID。 路径参数(由 Gateway 注入)
connectionNameStringRequiredbody连接显示名称。 不能为空
partnerEndpointStringRequiredbody合作伙伴 API 端点 URL。 不能为空
slashApiBaseUrlStringRequiredbodySlash 平台 API 基础 URL。 不能为空
slashApiKeyStringRequiredbody用于 Slash 鉴权的 API Key。 不能为空
slashAccountIdStringRequiredbodySlash 账户标识符。 不能为空
slashWebhookSecretStringRequiredbody用于签名验证的 Webhook 密钥。 不能为空
tenantBizIdStringOptionalbody租户业务 ID。省略时自动解析。

成功响应

Bad Request 400
{
  "code": "4000",
  "message": "connectionName must not be blank"
}

错误响应

HTTP 状态码错误码描述
4004000校验错误(缺少必填字段)
4014010JWT token 无效或已过期
4034030权限不足

说明

  • 成功时返回 HTTP 201。
  • 敏感字段(slashApiKeyslashAccountIdslashWebhookSecret)在响应中已脱敏。
  • 连接创建时为 PENDING 状态 (20010201)。

SlaunchX Internal Documentation