Tool- / MCP-Liste abrufen

Ermöglicht das Abrufen der Tool- und MCP-Liste innerhalb einer bestimmten Organisation.

Über diese Schnittstelle können Sie die Tool- und MCP-Liste innerhalb einer bestimmten Organisation abrufen.

Anfragemethode

GET

Anfrage-URL

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

Authentifizierung der Anfrage

Basic-Authentifizierung mit DevKey / DevSecret auf Kontoebene.

Anfrage

Beispielanfrage

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}'

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Basic ${BASIC_TOKEN}	Basic Token als Base64-Kodierung von `DevKey:DevSecret`.

Anfrageparameter (Query Parameters)

Parameter	Typ	Beschreibung	required
org_id	String	Organisations-ID.	true
keyword	String	Schlüsselwort, Filterung nach Name oder Beschreibung.	false
plugin_type	String	Ressourcentyp, unterstützt `TOOL`, `MCP`; ohne Angabe werden Tool und MCP zurückgegeben.	false
available	Boolean	Ob nur verfügbare oder nicht verfügbare Ressourcen zurückgegeben werden.	false

Antwort

Beispielantwort

{ "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
    }
  ]
}

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
resource_id	String	Tool- oder MCP-ID.
name	String	Ressourcenname.
display_name	String	Anzeigename.
description	String	Beschreibung.
logo	String	URL des Symbols.
url	String	Serviceadresse.
plugin_type	String	Ressourcentyp, `TOOL` oder `MCP`.
available	Boolean	Ob verfügbar.
action_count	Integer	Anzahl der Actions.
create_time	Long	Erstellungszeitpunkt, Zeitstempel in Millisekunden.
update_time	Long	Aktualisierungszeitpunkt, Zeitstempel in Millisekunden.

Fehlerantwort

Feld	Typ	Beschreibung
code	Integer	Fehlercode.
message	String	Fehlerdetails.

Statuscodes

Statuscode	Beschreibung
200	Erfolgreich
400	Ungültige Parameter
401	Nicht autorisiert
403	Unzureichende Berechtigungen
429	Zu viele Anfragen
500	Serverfehler