รีเฟรชรายการเครื่องมือ MCP

รีเฟรชรายการเครื่องมือ MCP

รองรับการดึง tools ของ MCP Server ที่ระบุใหม่อีกครั้ง และอัปเดต actions

คุณสามารถใช้อินเทอร์เฟซนี้เพื่อดึง tools ของ MCP Server ที่ระบุใหม่อีกครั้ง และอัปเดต actions

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

POST

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

https://api.${endpoint}/v1/org/mcp/refresh

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

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

การร้องขอ

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

curl -X POST 'https://api.${endpoint}/v1/org/mcp/refresh' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -H 'Content-Type: application/json' \ -d '{ "org_id": "p-xxxx", "id": "mcp-xxxx" }'
                      
                      curl -X POST 'https://api.${endpoint}/v1/org/mcp/refresh' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{
    "org_id": "p-xxxx",
    "id": "mcp-xxxx"
  }'

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

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

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

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

พารามิเตอร์ ประเภท คำอธิบาย required
org_id String ID ขององค์กร true
id String ID ของ MCP true

การตอบกลับ

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

{ "code": 0, "message": "OK", "data": { "mcp_id": "mcp-xxxx", "action_count": 3, "available": true } }
                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "mcp_id": "mcp-xxxx",
    "action_count": 3,
    "available": true
  }
}

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

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

ฟิลด์ ประเภท คำอธิบาย
mcp_id String ID ของ MCP
action_count Integer จำนวน Action หลังการรีเฟรช
available Boolean MCP ใช้งานได้หรือไม่

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

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

รหัสสถานะ

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