สอบถามรายการเวอร์ชัน Workflow
สอบถามรายการเวอร์ชัน Workflow
รองรับการสอบถามรายการประวัติเวอร์ชันของ Workflow เป้าหมาย
อินเทอร์เฟซนี้ใช้ API Key ของ Workflow เป้าหมายในการยืนยันตัวตน และอนุญาตให้เรียกใช้ได้เฉพาะ Workflow ที่เปิดสิทธิ์การจัดการเวอร์ชันเท่านั้น
วิธีการร้องขอ
GET
URL สำหรับร้องขอ
https://api.${endpoint}/v1/workflow/version/list
การยืนยันตัวตนในการร้องขอ
ดูรายละเอียดได้ที่คำอธิบายวิธีการยืนยันตัวตนใน API Overview โปรดใช้ API Key ของ Workflow เป้าหมายเป็น token
การร้องขอ
ตัวอย่างการร้องขอ
curl -X GET 'https://api.${endpoint}/v1/workflow/version/list' \
-H 'Authorization: Bearer ${token}'
curl -X GET 'https://api.${endpoint}/v1/workflow/version/list' \
-H 'Authorization: Bearer ${token}'
บล็อกโค้ดนี้ในหน้าต่างลอย
Header สำหรับร้องขอ
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| Authorization | Bearer ${token} | ใช้ API Key ของ Workflow เป้าหมายในการยืนยันตัวตนของการเรียกใช้ |
พารามิเตอร์การร้องขอ
ไม่มี
การตอบกลับ
เนื้อหาการตอบกลับ
{
"code": 0,
"message": "OK",
"data": [
{
"id": "bv-xxxx",
"bot_id": "workflow-xxxx",
"create_time": 1786327712000,
"release_time": 1786327812000,
"version": "v2",
"version_desc": "Update workflow nodes",
"version_status": "PUBLISHED",
"creator_email": "owner@example.com"
}
]
}
{
"code": 0,
"message": "OK",
"data": [
{
"id": "bv-xxxx",
"bot_id": "workflow-xxxx",
"create_time": 1786327712000,
"release_time": 1786327812000,
"version": "v2",
"version_desc": "Update workflow nodes",
"version_status": "PUBLISHED",
"creator_email": "owner@example.com"
}
]
}
บล็อกโค้ดนี้ในหน้าต่างลอย
การตอบกลับเมื่อสำเร็จ
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| id | String | ID ของบันทึกเวอร์ชัน |
| bot_id | String | ID ของ Workflow |
| create_time | Long | เวลาสร้างเวอร์ชัน เป็น timestamp หน่วยมิลลิวินาที |
| release_time | Long | เวลาเผยแพร่ เป็น timestamp หน่วยมิลลิวินาที หากยังไม่เผยแพร่จะเป็นค่าว่าง |
| version | String | หมายเลขเวอร์ชัน |
| version_desc | String | คำอธิบายเวอร์ชัน |
| version_status | String | สถานะเวอร์ชัน |
| creator_email | String | อีเมลของผู้สร้าง |
การตอบกลับเมื่อผิดพลาด
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
| code | int | รหัสข้อผิดพลาด |
| message | string | ข้อความแสดงข้อผิดพลาด |
รหัสสถานะ
| รหัสสถานะ | คำอธิบาย |
|---|---|
| 200 | สำเร็จ |
| 401 | ไม่ได้รับอนุญาต |
| 403 | สิทธิ์ไม่เพียงพอ หรือ API Key ยังไม่ได้เปิดสิทธิ์การจัดการเวอร์ชัน |
| 429 | คำขอถี่เกินไป |
| 500 | ข้อผิดพลาดของเซิร์ฟเวอร์ |
