Teljes folyamat: Chat egy hívással JWT-val

Ez a dokumentum bemutatja, hogyan lehet egy teljes chat folyamatot végrehajtani JWT token hitelesítéssel. A folyamat két lépésből áll:

Bejelentkezés - JWT token lekérése
Chat hívás - A token használatával chat üzenet küldése

Lépés 1: Bejelentkezés (JWT token lekérése)

A bejelentkezés a /auth/login endpointon keresztül történik.

Request

Mező	Típus	Kötelező	Leírás
user_id	string	Igen	Felhasználó azonosító
tenant_id	string	Igen	Tenant azonosító
password	string	Igen	Felhasználói jelszó

Response

json

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer",
  "user_id": "user_123",
  "tenant_id": "tenant_456",
  "role": "editor",
  "expires_in": 3600
}

Python

python

import requests

BASE_URL = "https://<your-api-host>"

url = f"{BASE_URL}/auth/login"
payload = {
    "user_id": "user_123",
    "tenant_id": "tenant_456",
    "password": "jelszo123"
}

headers = {
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

if response.status_code == 200:
    data = response.json()
    access_token = data["access_token"]
    print(f"Token lekérve: {access_token[:50]}...")
else:
    print(f"Hiba: {response.status_code} - {response.text}")

TypeScript

typescript

const BASE_URL = "https://<your-api-host>";

const url = `${BASE_URL}/auth/login`;
const payload = {
    user_id: "user_123",
    tenant_id: "tenant_456",
    password: "jelszo123"
};

const headers = {
    "Content-Type": "application/json"
};

const response = await fetch(url, {
    method: "POST",
    headers: headers,
    body: JSON.stringify(payload)
});

if (response.status === 200) {
    const data = await response.json();
    const access_token = data.access_token;
    console.log(`Token lekérve: ${access_token.substring(0, 50)}...`);
} else {
    console.error(`Hiba: ${response.status} - ${response.statusText}`);
}

cURL

bash

curl -X POST "$BASE_URL/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "user_123", "tenant_id": "tenant_456", "password": "jelszo123"}'

PHP

php

<?php
$BASE_URL = "https://<your-api-host>";

$url = $BASE_URL . "/auth/login";
$payload = json_encode([
    "user_id" => "user_123",
    "tenant_id" => "tenant_456",
    "password" => "jelszo123"
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_MAXREDIRS, 10);

$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($http_code === 200) {
    $data = json_decode($response, true);
    $access_token = $data['access_token'];
    echo "Token lekérve: " . substr($access_token, 0, 50) . "...\n";
} else {
    echo "Hiba: $http_code - $response\n";
}
?>

Lépés 2: Chat hívás JWT tokennel

A lekért JWT token használatával chat üzenet küldhető a POST /chat/stream endpointon keresztül (SSE stream válasz).

Request

Mező	Típus	Kötelező	Leírás
channel	string	Igen	`internal` (JWT hitelesítés) vagy `public`
text	string	Igen	A felhasználó üzenete
session_id	string	Igen	Session azonosító
tenant_id	string	Nem	Opcionális (JWT-ből jön)
user_id	string	Nem	Opcionális (JWT-ből jön)

Headers

Authorization: Bearer <access_token>
Content-Type: application/json

Response

json

{
  "event_type": "header",
  "data": {
    "trace_id": "abc-123-def-456",
    "mode": "DOC",
    "status_code": "OK"
  }
}

data: {"event_type":"delta","data":{"text":"Ez a válasz..."}}

data: {"event_type":"footer","data":{"sources":[],"tool_proposal":null,"internal_debug":null}}

Python

python

import requests

BASE_URL = "https://<your-api-host>"

# JWT token a bejelentkezésből
access_token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

url = f"{BASE_URL}/chat/stream"
payload = {
    "channel": "internal",
    "text": "Mi a cégetek fő szolgáltatása?",
    "session_id": "chat-session-123"
}

headers = {
    "Authorization": f"Bearer {access_token}",
    "Content-Type": "application/json",
    "Accept": "text/event-stream"
}

response = requests.post(url, json=payload, headers=headers, stream=True)

# Stream feldolgozás
for line in response.iter_lines():
    if line:
        data = line.decode('utf-8')
        if data.startswith("data: "):
            event_type = data[6:].split(":")[0]
            event_data = data[6:].split(":")[1]
            print(f"{event_type}: {event_data}")

TypeScript

typescript

const BASE_URL = "https://<your-api-host>";

// JWT token a bejelentkezésből
const access_token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...";

const url = `${BASE_URL}/chat/stream`;
const payload = {
    channel: "internal",
    text: "Mi a cégetek fő szolgáltatása?",
    session_id: "chat-session-123"
};

const headers = {
    "Authorization": `Bearer ${access_token}`,
    "Content-Type": "application/json",
    "Accept": "text/event-stream"
};

const response = await fetch(url, {
    method: "POST",
    headers: headers,
    body: JSON.stringify(payload)
});

// Stream feldolgozás
const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
    const { done, value } = await reader.read();
    if (done) break;

    const lines = decoder.decode(value, { stream: true }).split('\n');
    for (const line of lines) {
        if (line.startsWith('data: ')) {
            const event_part = line.substring(6);
            const event_type = event_part.split(":")[0];
            const event_data = event_part.split(":")[1];
            console.log(`${event_type}: ${event_data}`);
        }
    }
}

cURL

bash

curl -X POST "$BASE_URL/chat/stream" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{"channel": "internal", "text": "Mi a cégetek fő szolgáltatása?", "session_id": "chat-session-123"}'

PHP

php

<?php
$BASE_URL = "https://<your-api-host>";

// JWT token a bejelentkezésből
$access_token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...";

$url = $BASE_URL . "/chat/stream";
$payload = json_encode([
    "channel" => "internal",
    "text" => "Mi a cégetek fő szolgáltatása?",
    "session_id" => "chat-session-123"
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer $access_token",
    "Content-Type: application/json",
    "Accept: text/event-stream"
]);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_MAXREDIRS, 10);

$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($http_code === 200) {
    // Stream feldolgozás
    $lines = explode("\n", $response);
    foreach ($lines as $line) {
        if (strpos($line, 'data: ') === 0) {
            $event_part = substr($line, 6);
            $parts = explode(":", $event_part, 2);
            $event_type = $parts[0];
            $event_data = $parts[1] ?? '';
            echo "$event_type: $event_data\n";
        }
    }
} else {
    echo "Hiba: $http_code - $response\n";
}
?>

Teljes folyamat (Python)

Ez a példa mutatja be a teljes folyamatot: bejelentkezés → chat hívás.

python

import requests
import json

BASE_URL = "https://<your-api-host>"

# 1. Bejelentkezés
login_url = f"{BASE_URL}/auth/login"
login_payload = {
    "user_id": "user_123",
    "tenant_id": "tenant_456",
    "password": "jelszo123"
}

login_response = requests.post(login_url, json=login_payload)
if login_response.status_code == 200:
    data = login_response.json()
    access_token = data["access_token"]
    print("Bejelentkezés sikeres!")
else:
    print(f"Bejelentkezés sikertelen: {login_response.status_code}")
    exit(1)

# 2. Chat hívás
chat_url = f"{BASE_URL}/chat/stream"
chat_payload = {
    "channel": "internal",
    "text": "Mi a cégetek fő szolgáltatása?",
    "session_id": "chat-session-123"
}

headers = {
    "Authorization": f"Bearer {access_token}",
    "Content-Type": "application/json",
    "Accept": "text/event-stream"
}

chat_response = requests.post(chat_url, json=chat_payload, headers=headers, stream=True)

# Stream feldolgozás
for line in chat_response.iter_lines():
    if line:
        data = line.decode('utf-8')
        if data.startswith("data: "):
            event_type = data[6:].split(":")[0]
            event_data = data[6:].split(":")[1]
            
            if event_type == "header":
                header_data = json.loads(event_data)
                print(f"Trace ID: {header_data['data']['trace_id']}")
            
            elif event_type == "delta":
                delta_data = json.loads(event_data)
                print(delta_data['data']['text'], end='', flush=True)
            
            elif event_type == "footer":
                footer_data = json.loads(event_data)
                print(f"\n\n[Válasz készült! Források: {len(footer_data['data']['sources'])}]")

Teljes folyamat (TypeScript)

typescript

const BASE_URL = "https://<your-api-host>";

// 1. Bejelentkezés
const login_url = `${BASE_URL}/auth/login`;
const login_payload = {
    user_id: "user_123",
    tenant_id: "tenant_456",
    password: "jelszo123"
};

const login_response = await fetch(login_url, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(login_payload)
});

if (login_response.status === 200) {
    const data = await login_response.json();
    const access_token = data.access_token;
    console.log("Bejelentkezés sikeres!");
} else {
    console.error(`Bejelentkezés sikertelen: ${login_response.status}`);
    process.exit(1);
}

// 2. Chat hívás
const chat_url = `${BASE_URL}/chat/stream`;
const chat_payload = {
    channel: "internal",
    text: "Mi a cégetek fő szolgáltatása?",
    session_id: "chat-session-123"
};

const headers = {
    "Authorization": `Bearer ${access_token}`,
    "Content-Type": "application/json",
    "Accept": "text/event-stream"
};

const chat_response = await fetch(chat_url, {
    method: "POST",
    headers: headers,
    body: JSON.stringify(chat_payload)
});

// Stream feldolgozás
const reader = chat_response.body.getReader();
const decoder = new TextDecoder();

while (true) {
    const { done, value } = await reader.read();
    if (done) break;

    const lines = decoder.decode(value, { stream: true }).split('\n');
    for (const line of lines) {
        if (line.startsWith('data: ')) {
            const event_part = line.substring(6);
            const event_type = event_part.split(":")[0];
            const event_data = JSON.parse(event_part);
            
            if (event_type === "header") {
                console.log(`Trace ID: ${event_data.data.trace_id}`);
            }
            
            else if (event_type === "delta") {
                process.stdout.write(event_data.data.text);
            }
            
            else if (event_type === "footer") {
                console.log(`\n\n[Válasz készült! Források: ${event_data.data.sources.length}]`);
            }
        }
    }
}

Tippek

Token élettartam: A JWT token élettartama általában 1 óra (3600 másodperc). Ha a token lejárt, új bejelentkezést kell végezni.
Session ID: A session_id-t használhatod a felhasználói sessionok nyomon követéséhez.
Channel: Az internal channel JWT token hitelesítést igényel. A public channel widget token hitelesítést igényel.
Trace ID: A trace_id-t használhatod a válaszok nyomon követéséhez és hibakereséshez.
Rate Limit: Az endpoint rate limiteltek. Ha túlléped a limitet, 429-es hivatkozást kapsz.

Hibák

HTTP kód	Leírás
401	Érvénytelen vagy lejárt JWT token
400	Hiányzó vagy érvénytelen request body
429	Rate limit túllépés
503	Szolgáltatás nem elérhető

További információ

API dokumentációk

docs – Swagger UI. Interaktív API dokumentáció: endpointok böngészése, kérések kipróbálása a böngészőből. Mire való: chat, streaming, hitelesítés, RAG és admin API gyors tesztelése.
redoc – Redoc. Olvasható, struktúrált API leírás request/response sémákkal. Mire való: endpointok és adatmodellek áttekintése, integráció tervezése.
openapi.json – JSON API (OpenAPI 3.0 specifikáció). Géppel feldolgozható séma: endpointok, paraméterek, sémák. Mire való: kliensgenerálás, automatizált tesztek, dokumentáció- és integrációs eszközök.

Teljes folyamat: Chat egy hívással JWT-val ​

Lépés 1: Bejelentkezés (JWT token lekérése) ​

Request ​

Response ​

Python ​

TypeScript ​

cURL ​

PHP ​

Lépés 2: Chat hívás JWT tokennel ​

Request ​

Headers ​

Response ​

Python ​

TypeScript ​

cURL ​

PHP ​

Teljes folyamat (Python) ​

Teljes folyamat (TypeScript) ​

Tippek ​

Hibák ​

További információ ​

API dokumentációk ​

Teljes folyamat: Chat egy hívással JWT-val

Lépés 1: Bejelentkezés (JWT token lekérése)

Request

Response

Python

TypeScript

cURL

PHP

Lépés 2: Chat hívás JWT tokennel

Request

Headers

Response

Python

TypeScript

cURL

PHP

Teljes folyamat (Python)

Teljes folyamat (TypeScript)

Tippek

Hibák

További információ

API dokumentációk