สอบถามรายการ Tool / MCP

รองรับการสอบถามรายการ Tool และ MCP ภายใต้องค์กรที่ระบุ

คุณสามารถใช้อินเทอร์เฟซนี้เพื่อสอบถามรายการ Tool และ MCP ภายใต้องค์กรที่ระบุ

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

GET

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

https://api.${endpoint}/v1/org/tool/list

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

ใช้การยืนยันตัวตนแบบ Basic ด้วย DevKey / DevSecret ระดับบัญชี

การร้องขอ

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

curl -X GET 'https://api.${endpoint}/v1/org/tool/list?org_id=p-xxxx&plugin_type=TOOL&available=true&keyword=weather' \ -H 'Authorization: Basic ${BASIC_TOKEN}'

                      
                      curl -X GET 'https://api.${endpoint}/v1/org/tool/list?org_id=p-xxxx&plugin_type=TOOL&available=true&keyword=weather' \
  -H 'Authorization: Basic ${BASIC_TOKEN}'

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

ฟิลด์	ประเภท	คำอธิบาย
Authorization	Basic ${BASIC_TOKEN}	Basic Token ที่ได้จากการเข้ารหัส Base64 ของ `DevKey:DevSecret`

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

พารามิเตอร์	ประเภท	คำอธิบาย	required
org_id	String	ID ขององค์กร	true
keyword	String	คำสำคัญ กรองตามชื่อหรือคำอธิบาย	false
plugin_type	String	ประเภททรัพยากร รองรับ `TOOL`, `MCP` หากไม่ส่งมาจะคืนทั้ง Tool และ MCP	false
available	Boolean	จะคืนเฉพาะทรัพยากรที่ใช้งานได้หรือไม่ได้เท่านั้นหรือไม่	false

การตอบกลับ

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

{ "code": 0, "message": "OK", "data": [ { "resource_id": "tool-xxxx", "name": "weather", "display_name": "Weather Lookup", "description": "Query current weather", "logo": "https://cdn.example.com/weather.png", "url": "https://api.example.com", "plugin_type": "TOOL", "available": true, "action_count": 2, "create_time": 1785826041000, "update_time": 1785826041000 } ] }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": [
    {
      "resource_id": "tool-xxxx",
      "name": "weather",
      "display_name": "Weather Lookup",
      "description": "Query current weather",
      "logo": "https://cdn.example.com/weather.png",
      "url": "https://api.example.com",
      "plugin_type": "TOOL",
      "available": true,
      "action_count": 2,
      "create_time": 1785826041000,
      "update_time": 1785826041000
    }
  ]
}