透過 URL 匯入 Skill 包

支援從公網 URL 下載技能安裝包並匯入為組織 Skill。

可以透過該 API，從公網 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	伺服器錯誤