Interroger la liste des Tools / MCP

Permet d'interroger la liste des Tools et MCP au sein de l'organisation spécifiée.

Cette interface permet d'interroger la liste des Tools et MCP au sein de l'organisation spécifiée.

Méthode de requête

GET

URL de la requête

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

Authentification de la requête

Utilise l'authentification Basic avec la DevKey / le DevSecret de niveau compte.

Requête

Exemple de requête

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

Ce bloc de code dans la fenêtre flottante

En-têtes de la requête

Champ	Type	Description
Authorization	Basic ${BASIC_TOKEN}	Utilisez le Basic Token obtenu en encodant `DevKey:DevSecret` en Base64.

Paramètres de la requête (Query Parameters)

Champ	Type	Description	required
org_id	String	ID de l'organisation.	true
keyword	String	Mot-clé, filtre par nom ou description.	false
plugin_type	String	Type de ressource, prend en charge `TOOL`, `MCP` ; renvoie les Tools et les MCP s'il n'est pas fourni.	false
available	Boolean	Indique s'il faut ne renvoyer que les ressources disponibles ou indisponibles.	false

Réponse

Exemple de réponse

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

Ce bloc de code dans la fenêtre flottante

Réponse en cas de succès

Champ	Type	Description
resource_id	String	ID du Tool ou du MCP.
name	String	Nom de la ressource.
display_name	String	Nom d'affichage.
description	String	Description.
logo	String	URL de l'icône.
url	String	Adresse du service.
plugin_type	String	Type de ressource, `TOOL` ou `MCP`.
available	Boolean	Indique si la ressource est disponible.
action_count	Integer	Nombre d'Actions.
create_time	Long	Date de création, horodatage en millisecondes.
update_time	Long	Date de mise à jour, horodatage en millisecondes.

Réponse en cas d'échec

Champ	Type	Description
code	Integer	Code d'erreur.
message	String	Détails de l'erreur.

Codes d'état

Code d'état	Description
200	Succès
400	Erreur de paramètre
401	Non autorisé
403	Autorisation insuffisante
429	Requêtes trop fréquentes
500	Erreur du serveur