更新卡片
POST
/web/v1/slash/connections/{connectionBizId}/cards/update JWT更新指定 Slash 连接下已有卡片的属性。
鉴权
需要有效的 JWT token。Portal 访问权限:system、tenant。
请求参数
| Name | Type | Required | In | Description |
|---|---|---|---|---|
connectionBizId | String | Required | path | Slash 连接业务 ID。 路径参数 |
cardId | String | Required | body | 要更新的卡片 ID。 请求体字段,不能为空 |
payload | Object | Required | body | 转发至 Slash 平台的更新载荷。 请求体字段,不能为 null |
成功响应
Bad Request 400
{
"code": "4000",
"message": "cardId must not be blank"
}错误响应
| HTTP 状态码 | 错误码 | 描述 |
|---|---|---|
| 400 | 4000 | 校验错误(缺少 cardId 或 payload) |
| 401 | 4010 | 无效或过期的 JWT token |
| 404 | 4040 | 卡片或连接未找到 |
说明
cardId和payload字段由服务端校验,两者均为必填。payload对象将原样转发至 Slash 平台。