Zum Hauptinhalt springen
POST
Sitzung erstellen

Sitzung erstellen

POST /v1/agent-sessions Erstellt eine neue authentifizierte Sitzung für einen Maschinenagenten. Die Sitzung bindet ein zeitlich begrenztes Zugriffstoken und ein Aktualisierungstoken an den Agenten, mit einem expliziten Satz von Scopes, der eine Untermenge der dem Agenten gewährten Scopes sein muss. Die token und refresh_token werden nur in der Erstellungsantwort zurückgegeben. Speichern Sie sie sicher – sie können später nicht wiederhergestellt werden.
Die Felder token und refresh_token werden in dieser Antwort. Speichern Sie sie in einem sicheren Secrets Manager oder verschlüsselten Speicher sofort. Bei Verlust die Sitzung beenden und eine neue erstellen.

Authentifizierung

Erfordert X-API-Key Header oder Bearer JWT Token. Der Arbeitsbereich wird aus den authentifizierten Anmeldeinformationen abgeleitet; senden Sie X-Tenant-ID nicht.

Antwort

object
Das erstellte Sitzungsobjekt enthält:
string
Interner UUID-Primärschlüssel.
string
MAIP-Sitzungsbezeichner im Format maip-sess:<short-uuid>:<random-hex>. Verwenden Sie diese ID in nachfolgenden API-Aufrufen.
string
Der Agent, zu dem diese Sitzung gehört.
string
Sitzungsstatus. Bei der Erstellung immer "active".
string[]
Die effektiven Scopes für diese Sitzung.
object
Sitzungsmetadaten.
string
ISO 8601 Ablaufzeitstempel.
string
ISO 8601 Erstellungszeitstempel.
string
ISO 8601 Zeitstempel der letzten Aktualisierung.
string
Opaker Zugriffstoken zur Authentifizierung von API-Anfragen innerhalb dieser Sitzung. 64-stelliger Hex-String. Nur einmal zurückgegeben.
string
Token zum Aktualisieren der Sitzung vor Ablauf. 64-stelliger Hex-String. Wird nur einmal zurückgegeben.

Beispiel


Sitzungslebenszyklus

Ein Sitzungsbeleg wird automatisch erstellt, wenn die Sitzung beginnt, und verknüpft die Sitzung mit dem Audit-Trail des Agenten.

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Body

application/json
agent_id
string<uuid>
erforderlich

Agent, für den die Sitzung erstellt werden soll

metadata
any
scopes
string[]

Bereiche für diese Sitzung (muss eine Untermenge der Agentenbereiche sein)

ttl_minutes
integer

Antwort

Sitzung erstellt

session_id
string<uuid>
agent_id
string<uuid>
token
string

Sitzungs-Bearer-Token (einmalig bei Erstellung zurückgegeben)

scopes
string[]
status
enum<string>
Verfügbare Optionen:
active,
terminated,
expired
metadata
object
expires_at
string<date-time>
created_at
string<date-time>
terminated_at
string<date-time>