นำเข้าสร้าง Skill ผ่านไฟล์

นำเข้าสร้าง Skill ผ่านไฟล์

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

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

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

POST

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

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

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

ใช้การยืนยันตัวตนแบบ Basic ด้วย DevKey / DevSecret ระดับบัญชี และกำหนดให้บัญชีที่เรียกใช้ต้องมีสิทธิ์สร้าง Skill ขององค์กร

การร้องขอ

ตัวอย่างการร้องขอ

curl -X POST 'https://api.${endpoint}/v1/org/skill/import' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -F 'file=@/path/to/refund-policy.skill' \ -F 'org_id=p-xxxx' \ -F 'category_id=cat-xxxx'
                      
                      curl -X POST 'https://api.${endpoint}/v1/org/skill/import' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -F 'file=@/path/to/refund-policy.skill' \
  -F 'org_id=p-xxxx' \
  -F 'category_id=cat-xxxx'

                    
บล็อกโค้ดนี้ในหน้าต่างลอย

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

ฟิลด์ ประเภท คำอธิบาย
Authorization Basic ${BASIC_TOKEN} Basic Token ที่ได้จากการเข้ารหัส Base64 ของ DevKey:DevSecret
Content-Type multipart/form-data ฟอร์มสำหรับอัปโหลดไฟล์

พารามิเตอร์การร้องขอ (Form Data)

พารามิเตอร์ ประเภท คำอธิบาย required
file File แพ็กเกจติดตั้ง Skill แบบ .zip หรือ .skill true
org_id String ID ขององค์กร true
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"
  }
}

                    
บล็อกโค้ดนี้ในหน้าต่างลอย

การตอบกลับเมื่อสำเร็จ

ฟิลด์ ประเภท คำอธิบาย
skill_id String ID ของ Skill หลังการนำเข้า
name String ชื่อ Skill
owner_type String ประเภทเจ้าของ Skill

การตอบกลับเมื่อผิดพลาด

ฟิลด์ ประเภท คำอธิบาย
code Integer รหัสข้อผิดพลาด
message String รายละเอียดข้อผิดพลาด

รหัสสถานะ

รหัสสถานะ คำอธิบาย
200 สำเร็จ
400 พารามิเตอร์ไม่ถูกต้อง
401 ไม่ได้รับอนุญาต
403 สิทธิ์ไม่เพียงพอ
429 คำขอถี่เกินไป
500 ข้อผิดพลาดของเซิร์ฟเวอร์