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