通过 URL 导入 Skill 包
通过 URL 导入 Skill 包
支持从公网 URL 下载技能安装包并导入为组织 Skill。
可以通过该接口，从公网 URL 下载 .zip 或 .skill 技能安装包，并导入为组织 Skill。
请求方式
POST
调用地址
https://api.${endpoint}/v1/org/skill/import/url
调用验证
使用账号级 DevKey / DevSecret 的 Basic 鉴权，并要求调用账号具备组织 Skill 创建权限。
请求
请求示例
curl -X POST 'https://api.${endpoint}/v1/org/skill/import/url' \
-H 'Authorization: Basic ${BASIC_TOKEN}' \
-H 'Content-Type: application/json' \
-d '{
"org_id": "p-xxxx",
"package_url": "https://trusted.example.com/refund-policy.skill",
"file_name": "refund-policy.skill",
"category_id": "cat-xxxx"
}'
curl -X POST 'https://api.${endpoint}/v1/org/skill/import/url' \
-H 'Authorization: Basic ${BASIC_TOKEN}' \
-H 'Content-Type: application/json' \
-d '{
"org_id": "p-xxxx",
"package_url": "https://trusted.example.com/refund-policy.skill",
"file_name": "refund-policy.skill",
"category_id": "cat-xxxx"
}'
此代码块在浮窗中显示
请求头
| 字段 | 类型 | 说明 |
|---|---|---|
| Authorization | Basic ${BASIC_TOKEN} | 使用 DevKey:DevSecret Base64 后的 Basic Token。 |
| Content-Type | application/json | 请求体格式。 |
请求参数（Body Parameters）
| 参数 | 类型 | 说明 | required |
|---|---|---|---|
| org_id | String | 组织 ID。 | true |
| package_url | String | 技能安装包公网 URL，必须为 http/https，并命中服务端白名单 openapi.skill-package.allowed-hosts。 |
true |
| file_name | String | 文件名；不传时从 URL 推断。 | false |
| category_id | String | Skill 分类 ID。 | false |
响应
响应示例
{
"code": 0,
"message": "OK",
"data": {
"skill_id": "skill-xxxx",
"name": "refund-policy",
"owner_type": "ORGANIZATION"
}
}
{
"code": 0,
"message": "OK",
"data": {
"skill_id": "skill-xxxx",
"name": "refund-policy",
"owner_type": "ORGANIZATION"
}
}
此代码块在浮窗中显示
成功响应
| 字段 | 类型 | 说明 |
|---|---|---|
| skill_id | String | 导入后的 Skill ID。 |
| name | String | Skill 名称。 |
| owner_type | String | Skill 归属类型。 |
失败响应
| 字段 | 类型 | 说明 |
|---|---|---|
| code | Integer | 错误码。 |
| message | String | 错误详情。 |
状态码
| 状态码 | 说明 |
|---|---|
| 200 | 成功 |
| 400 | 参数错误 |
| 401 | 未授权 |
| 403 | 权限不足 |
| 429 | 请求过于频繁 |
| 500 | 服务器错误 |