สอบถามรายการเวอร์ชัน 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 ข้อผิดพลาดของเซิร์ฟเวอร์