删除 Skill
删除 Skill
支持删除指定组织下的 Skill。
可以通过该接口,删除指定组织下的 Skill。删除时会级联清理技能草稿、版本快照和技能包文件记录。
请求方式
POST
调用地址
https://api.${endpoint}/v1/org/skill/delete
调用验证
使用账号级 DevKey / DevSecret 的 Basic 鉴权,并要求调用账号具备组织 Skill 删除权限。
请求
请求示例
curl -X POST 'https://api.${endpoint}/v1/org/skill/delete' \
-H 'Authorization: Basic ${BASIC_TOKEN}' \
-H 'Content-Type: application/json' \
-d '{
"org_id": "p-xxxx",
"skill_id": "skill-xxxx"
}'
curl -X POST 'https://api.${endpoint}/v1/org/skill/delete' \
-H 'Authorization: Basic ${BASIC_TOKEN}' \
-H 'Content-Type: application/json' \
-d '{
"org_id": "p-xxxx",
"skill_id": "skill-xxxx"
}'
此代码块在浮窗中显示
请求头
| 字段 | 类型 | 说明 |
|---|---|---|
| Authorization | Basic ${BASIC_TOKEN} | 使用 DevKey:DevSecret Base64 后的 Basic Token。 |
| Content-Type | application/json | 请求体格式。 |
请求参数(Body Parameters)
| 参数 | 类型 | 说明 | required |
|---|---|---|---|
| org_id | String | 组织 ID。 | true |
| skill_id | String | Skill ID。 | true |
响应
响应示例
{
"code": 0,
"message": "OK",
"affect_count": 1
}
{
"code": 0,
"message": "OK",
"affect_count": 1
}
此代码块在浮窗中显示
成功响应
| 字段 | 类型 | 说明 |
|---|---|---|
| affect_count | Integer | 影响记录数。 |
失败响应
| 字段 | 类型 | 说明 |
|---|---|---|
| code | Integer | 错误码。 |
| message | String | 错误详情。 |
状态码
| 状态码 | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 参数错误 |
| 401 | 未授权 |
| 403 | 权限不足 |
| 429 | 请求过于频繁 |
| 500 | 服务器错误 |
