นำเข้าแพ็กเกจ Skill ผ่าน URL

รองรับการดาวน์โหลดแพ็กเกจติดตั้ง Skill จาก URL บนอินเทอร์เน็ตสาธารณะ และนำเข้าเป็น Skill ขององค์กร

คุณสามารถใช้อินเทอร์เฟซนี้เพื่อดาวน์โหลดแพ็กเกจติดตั้ง Skill แบบ .zip หรือ .skill จาก URL บนอินเทอร์เน็ตสาธารณะ และนำเข้าเป็น Skill ขององค์กร

วิธีการร้องขอ

POST

URL สำหรับร้องขอ

https://api.${endpoint}/v1/org/skill/import/url

การยืนยันตัวตนในการร้องขอ

ใช้การยืนยันตัวตนแบบ Basic ด้วย DevKey / DevSecret ระดับบัญชี และกำหนดให้บัญชีที่เรียกใช้ต้องมีสิทธิ์สร้าง 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}	Basic Token ที่ได้จากการเข้ารหัส Base64 ของ `DevKey:DevSecret`
Content-Type	application/json	รูปแบบของเนื้อหาคำขอ

พารามิเตอร์การร้องขอ (Body Parameters)

พารามิเตอร์	ประเภท	คำอธิบาย	required
org_id	String	ID ขององค์กร	true
package_url	String	URL บนอินเทอร์เน็ตสาธารณะของแพ็กเกจติดตั้ง Skill ต้องเป็น `http/https` และตรงกับ whitelist ฝั่งเซิร์ฟเวอร์ `openapi.skill-package.allowed-hosts`	true
file_name	String	ชื่อไฟล์ หากไม่ระบุจะอนุมานจาก URL	false
category_id	String	ID หมวดหมู่ Skill	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"
  }
}