更新卡片
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 平台。