Desktop-Auth

curl -X POST "https://api.talkturo.com/api/auth/sign-in" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "jane.chen@acme.co",
    "password": "DeskPass_73A9"
  }'

const response = await fetch("https://api.talkturo.com/api/auth/sign-in", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    email: "jane.chen@acme.co",
    password: "DeskPass_73A9"
  })
});

const result = await response.json();
console.log(result);

{
  "success": true,
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.desktop_example_access",
    "refresh_token": "refresh_example_q9K2mL7xP4vN8cR1",
    "expires_in": 3600,
    "expires_at": 1735693200,
    "token_type": "bearer",
    "user": {
      "id": "9f3b6e2a-4d85-4d62-95de-f2ec7e4ac8b1",
      "email": "jane.chen@acme.co",
      "user_metadata": {
        "full_name": "Jane Chen"
      }
    }
  }
}

{
  "success": false,
  "error": "Invalid login credentials"
}

curl -X POST "https://api.talkturo.com/api/auth/refresh" \
  -H "Content-Type: application/json" \
  -d '{
    "refresh_token": "refresh_example_q9K2mL7xP4vN8cR1"
  }'

const response = await fetch("https://api.talkturo.com/api/auth/refresh", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    refresh_token: "refresh_example_q9K2mL7xP4vN8cR1"
  })
});

const result = await response.json();
console.log(result);

{
  "success": true,
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.desktop_example_new_access",
    "refresh_token": "refresh_example_h3M8qT1vL6pW2nZ5",
    "expires_in": 3600,
    "expires_at": 1735696800,
    "token_type": "bearer",
    "user": {
      "id": "9f3b6e2a-4d85-4d62-95de-f2ec7e4ac8b1",
      "email": "jane.chen@acme.co",
      "user_metadata": {
        "full_name": "Jane Chen"
      }
    }
  }
}

Desktop-Clients authentifizieren

Verwenden Sie die Desktop-Auth-Endpunkte, um Benutzer anzumelden, Konten zu erstellen, abgelaufene Access-Token zu aktualisieren und Sitzungen zu widerrufen. Diese Routen sind für die Close-AI-Desktop-App und jeden Client ausgelegt, der sich mit Supabase-JWTs statt mit Browser-Cookies authentifiziert.

Endpunktübersicht

Authentifizierungsmodell

Desktop-Clients authentifizieren sich, indem sie ein Supabase-Access-Token im Authorization-Header als Bearer-Token senden. Speichern Sie nach Anmeldung oder Aktualisierung sowohl access_token als auch refresh_token und verwenden Sie das Access-Token für geschützte Desktop-Routen.

POST /api/auth/sign-out führt eine globale Abmeldung durch. Dadurch werden alle Refresh-Token des Benutzers ungültig, nicht nur das Token des aktuellen Geräts.

POST /api/auth/sign-in

Tauschen Sie eine E-Mail-Adresse und ein Passwort gegen ein Supabase-Sitzungs-Token-Paar.

Anfragebeispiel

Body-Parameter

Felder der Erfolgsantwort

Felder der Fehlerantwort

POST /api/auth/sign-up

Erstellen Sie ein neues Konto mit E-Mail-Adresse und Passwort. Je nach Einstellungen Ihres Supabase-Projekts gibt der Endpunkt entweder sofort eine vollständige Sitzung zurück oder ein Benutzerobjekt mit needs_email_confirm auf true.

Body-Parameter

Antwortverhalten

Wenn keine E-Mail-Bestätigung erforderlich ist, enthält die Antwort dieselben Token-Felder wie bei der Anmeldung sowie needs_email_confirm: false.

Wenn eine E-Mail-Bestätigung erforderlich ist, enthält die Antwort needs_email_confirm: true und ein user-Objekt, aber noch keine aktiven Sitzungs-Token.

Felder der Erfolgsantwort

POST /api/auth/sign-out

Widerrufen Sie die Refresh-Token des aktuellen Benutzers global. Senden Sie das aktuelle Access-Token als Bearer-Token im Authorization-Header.

Header

Felder der Erfolgsantwort

POST /api/auth/refresh

Tauschen Sie ein Refresh-Token gegen ein neues Access-Token und Refresh-Token-Paar. Verwenden Sie diesen Endpunkt, wenn das aktuelle Access-Token abläuft.

Anfragebeispiel

Body-Parameter

Felder der Erfolgsantwort

Browser-Handler

Zwei verwandte Routen unterstützen browserbasierte Auth-Flows. Sie gehören zum Auth-System, sind aber keine Token-Austausch-Endpunkte für Desktop-Clients.

GET /api/auth/callback

Verarbeitet den Supabase-OAuth-Callback in browserbasierten Anmelde-Flows.

GET /api/auth/confirm

Verarbeitet die E-Mail-Bestätigung nach der Registrierung.

Typischer Desktop-Token-Flow

Speichern Sie das Refresh-Token sicher und behandeln Sie das Access-Token als kurzlebig. Ein typischer Desktop-Client-Flow sieht so aus:

Implementierungshinweise

Verwenden Sie den Authorization-Header nur bei Endpunkten, die ein Access-Token erfordern, z. B. Abmeldung und authentifizierte Desktop-Routen. Anmeldung, Registrierung und Aktualisierung akzeptieren alle JSON-Request-Bodies und erfordern keine bestehende Sitzung.

Ersetzen Sie bei erfolgreicher Aktualisierung beide gespeicherten Token. Die Antwort kann das Refresh-Token rotieren; die weitere Verwendung des alten Refresh-Tokens kann spätere Aktualisierungsversuche fehlschlagen lassen.