Interroger la liste des versions d'Agent

Permet d'interroger la liste de l'historique des versions de l'Agent cible.

Cette interface utilise la clé API Key de l'Agent cible pour l'authentification et ne peut être appelée que par les Agents ayant activé l'autorisation de gestion des versions.

Méthode de requête

GET

URL de la requête

https://api.${endpoint}/v1/agent/version/list

Authentification de la requête

Pour plus de détails, consultez les explications sur la méthode d'authentification dans la Présentation de l'API. Veuillez utiliser la clé API Key de l'Agent cible comme token.

Requête

Exemple de requête

curl -X GET 'https://api.${endpoint}/v1/agent/version/list' \ -H 'Authorization: Bearer ${token}'

                      
                      curl -X GET 'https://api.${endpoint}/v1/agent/version/list' \
  -H 'Authorization: Bearer ${token}'

Ce bloc de code dans la fenêtre flottante

En-têtes de la requête

Champ	Type	Description
Authorization	Bearer ${token}	Utilisez la clé API Key de l'Agent cible pour l'authentification des appels.

Paramètres de la requête

Aucun.

Réponse

Corps de la réponse

{ "code": 0, "message": "OK", "data": [ { "id": "bv-xxxx", "bot_id": "bot-xxxx", "create_time": 1786327712000, "release_time": 1786327812000, "version": "v2", "version_desc": "Update prompt and tools", "version_status": "PUBLISHED", "creator_email": "owner@example.com" } ] }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": [
    {
      "id": "bv-xxxx",
      "bot_id": "bot-xxxx",
      "create_time": 1786327712000,
      "release_time": 1786327812000,
      "version": "v2",
      "version_desc": "Update prompt and tools",
      "version_status": "PUBLISHED",
      "creator_email": "owner@example.com"
    }
  ]
}

Ce bloc de code dans la fenêtre flottante

Réponse en cas de succès

Champ	Type	Description
id	String	ID de l'enregistrement de version.
bot_id	String	ID de l'Agent.
create_time	Long	Date de création de la version, horodatage en millisecondes.
release_time	Long	Date de publication, horodatage en millisecondes ; vide si non publiée.
version	String	Numéro de version.
version_desc	String	Description de la version.
version_status	String	Statut de la version.
creator_email	String	Adresse e-mail du créateur.

Réponse en cas d'échec

Champ	Type	Description
code	int	Code d'erreur.
message	string	Message d'erreur.

Codes d'état

Code d'état	Description
200	Succès
401	Non autorisé
403	Autorisation insuffisante ou API Key sans autorisation de gestion des versions
429	Requêtes trop fréquentes
500	Erreur du serveur