UOA Logo

Uniquo OpenAi Api

V1

Warum Uniquo OpenAI API?

Eine klare, stabile und sichere Schnittstelle für Assistants, Threads und Messages – optimiert für produktive Integrationen.

Kernprinzipien

  • Einfach: konsistente Endpunkte, saubere Antworten
  • Sicher: tokenbasierte Authentifizierung
  • Schnell: schlanke JSON-Formate, Pagination
  • Nachvollziehbar: klare Fehlermeldungen

Schnellstart

  1. Authentifizieren und Token holen
  2. Assistant wählen
  3. Thread erstellen
  4. Nachrichten senden/abrufen

Standards

  • UTC-Zeitformat, ISO-konform
  • UTF-8, JSON über HTTPS
  • Klare Limits: limit/offset
  • Rollenbasierte Assistants

Happy Path

Der typische Flow vom Login bis zur Antwort des Assistenten.

GET
/client
Token mit API-Key und Client-ID anfordern.
GET
/assistants
Passenden Assistant anhand der Rolle finden.
POST
/threads
Neuen Thread mit dem Assistant starten.
POST
/threads/{id}/messages
Text- oder Audio-Nachricht senden und Antwort erhalten.
Gesamte API-Dokumentation mit Beispielen

Fehlerkultur

Klare, konsistente Fehlerrückgaben helfen bei Debugging und Monitoring.

  • 401 Unauthorized: Token fehlt/ist ungültig
  • 404 Not Found: Ressource nicht vorhanden
  • 422 Unprocessable Entity: Validierungsfehler
  • 429 Too Many Requests: Rate limit erreicht

Tipp: Wiederholbare Requests cachen, Audio als Base64 senden, Zeitzonen auf Clientseite passend darstellen.

Best Practices

  • Pagination immer setzen (limit/offset) für planbare Latenzen
  • Client-ID als stabile GUID nutzen
  • Thread-Titel sinnvoll pflegen für bessere Übersicht
  • Audio vor dem Senden lokal komprimieren, dann Base64
  • Fehler und Latenzen messen (ms) und in Logs aufnehmen