API สร้าง Skill องค์กร

API สร้าง Skill องค์กร

รองรับการสร้าง Skill ระดับองค์กรภายใต้องค์กรที่ระบุ คุณสามารถใช้อินเทอร์เฟซนี้เพื่อสร้าง Skill ระดับองค์กรภายใต้องค์กรที่ระบุได้

  • รองรับเฉพาะ .skill, .zip เท่านั้น ขนาดแพ็กเกจสูงสุด 20 MiB
  • ในไดเรกทอรีรากของแพ็กเกจ หรือภายใต้ไดเรกทอรีระดับบนสุดเพียงหนึ่งเดียว ต้องมี SKILL.md และ frontmatter ต้องมี name
  • หลังจากสร้างสำเร็จ ให้ใช้ POST /v1/org/skill/update และส่ง skill_id ใน Form Data เพื่ออัปเดต Skill นั้น

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

POST

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

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

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

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

การร้องขอ

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

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

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

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

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

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

พารามิเตอร์ ประเภท บังคับ คำอธิบาย
org_id String ใช่ ID ขององค์กรที่ต้องการสร้าง Skill แบบแชร์
file File ใช่ แพ็กเกจ Skill แบบ .skill หรือ .zip

การตอบกลับ

ตัวอย่างการตอบกลับ

{ "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 ข้อผิดพลาดของเซิร์ฟเวอร์