Provider

Listet konfigurierte KI-Provider und liefert Details zu einem Provider. Provider-Pfadtoken folgen den Anzeigename-Regeln der Übersicht KI Web API.

GET /api/ai/providers

Liefert alle konfigurierten Provider als JSON-Array.

RESPONSE-Feld	Werttyp	Beschreibung
`providerId`	string	Provider-Identifier. Entspricht dem konfigurierten Anzeigenamen.
`displayName`	string	Konfigurierter Anzeigename.
`providerType`	string	Provider-Typ-Schlüssel aus der Konfiguration.
`providerTypeDisplayName`	string	Anzeigename des Provider-Typs oder der Typ-Schlüssel, falls nicht auflösbar.
`defaultProvider`	boolean	`true` für den ersten konfigurierten Provider.
`uploadSupported`	boolean	`true`, wenn der Provider Ressourcen-Upload unterstützt.

Beispielanfrage

# Request
GET /api/ai/providers HTTP/1.1
Host: helpdesk.example.com
Authorization: Bearer <access_token>
 
# Response
HTTP/1.1 200 OK
Content-Type: application/json
 
[
  {
    "providerId": "Primary Provider",
    "displayName": "Primary Provider",
    "providerType": "openai",
    "providerTypeDisplayName": "OpenAI",
    "defaultProvider": true,
    "uploadSupported": true
  }
]

GET /api/ai/providers/default

Liefert den Standard-Provider. Liefert 404, wenn kein Provider konfiguriert ist.

Beispielanfrage

# Request
GET /api/ai/providers/default HTTP/1.1
Host: helpdesk.example.com
Authorization: Bearer <access_token>
 
# Response
HTTP/1.1 200 OK
Content-Type: application/json
 
{
  "providerId": "Primary Provider",
  "displayName": "Primary Provider",
  "providerType": "openai",
  "providerTypeDisplayName": "OpenAI",
  "defaultProvider": true,
  "uploadSupported": true
}

GET /api/ai/providers/<providerName>

Liefert einen Provider über das Namens-Token. Das Token kann der exakte Anzeigename oder die hyphenisierte Form sein. Unbekannte Provider oder verschachtelte Pfade liefern 404. Andere HTTP-Methoden liefern 405.

Beispielanfrage

# Request
# "Primary Provider" kann auch als Primary-Provider adressiert werden
GET /api/ai/providers/Primary-Provider HTTP/1.1
Host: helpdesk.example.com
Authorization: Bearer <access_token>
 
# Response
HTTP/1.1 200 OK
Content-Type: application/json
 
{
  "providerId": "Primary Provider",
  "displayName": "Primary Provider",
  "providerType": "openai",
  "providerTypeDisplayName": "OpenAI",
  "defaultProvider": true,
  "uploadSupported": true
}