Agent-Versionsliste abrufen

Ermöglicht das Abrufen der Versionsverlaufsliste des Ziel-Agent.

Diese Schnittstelle verwendet zur Authentifizierung den API Key des jeweiligen Ziel-Agent und kann nur von Agent aufgerufen werden, für die die Berechtigung zur Versionsverwaltung aktiviert ist.

Anfragemethode

GET

Anfrage-URL

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

Authentifizierung der Anfrage

Einzelheiten finden Sie in den Erläuterungen zur Authentifizierung in der API-Übersicht. Verwenden Sie den API Key des Ziel-Agent als token.

Anfrage

Beispielanfrage

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

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Bearer ${token}	Verwenden Sie den API Key des Ziel-Agent zur Authentifizierung der Anfrage.

Anfrageparameter

Keine.

Antwort

Antwort-Body

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

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
id	String	ID des Versionsdatensatzes.
bot_id	String	Agent-ID.
create_time	Long	Erstellungszeitpunkt der Version, Zeitstempel in Millisekunden.
release_time	Long	Veröffentlichungszeitpunkt, Zeitstempel in Millisekunden; leer, wenn nicht veröffentlicht.
version	String	Versionsnummer.
version_desc	String	Versionsbeschreibung.
version_status	String	Versionsstatus.
creator_email	String	E-Mail-Adresse des Erstellers.

Fehlerantwort

Feld	Typ	Beschreibung
code	int	Fehlercode.
message	string	Fehlermeldung.

Statuscodes

Statuscode	Beschreibung
200	Erfolgreich
401	Nicht autorisiert
403	Unzureichende Berechtigungen oder API Key hat keine Berechtigung zur Versionsverwaltung
429	Zu viele Anfragen
500	Serverfehler