Aller au contenu
SVEDA
FR
Menu

HOST

Host SDKs

Chaque host mint un embed token limité, puis la page ouvre le chat JS ou iframe. La clé API host ne quitte pas le serveur.

No framework Embed token

Host SDKs

Chaque host mint un embed token limité, puis la page ouvre le chat JS ou iframe. La clé API host ne quitte pas le serveur.

Étape par étape : mint de l’embed token en PHP, Laravel, Python, Node, Ruby, Go, Java, .NET ou sans framework.

No framework

A static page can open the chat. Something on your origin still has to mint the embed token — curl for local, or a tiny POST /sveda/session.

PHP

Framework-agnostic PHP. Factory::factory() → embed()->createToken(). Your page only receives origin and token.

Laravel

The package wraps sveda-ai/php-sdk, mints Sanctum MCP tokens, and exposes StartSidecarSessionController.

Python

One client. Flask, Django, and FastAPI are route wrappers. start_host_session returns origin, token, expires_in, appearance.

Node

Native fetch. startHostSession talks to the sidecar. The page still opens chat with data-sveda-open buttons.

Ruby

The gem mints embed tokens with Bearer host auth. Rails is a controller and a layout. Plain Ruby is the same HTTP call.

Go

No framework required. net/http plus the module is the host. Templates only render chat buttons when the origin is set.

Java

HttpClient transport. Spring Boot is a controller and Thymeleaf. The SDK does not need Spring.

.NET

net8.0 sveda-dotnet-sdk. ASP.NET is MapPost plus a layout. The library is usable from any HttpClient host.

Same handshake on every host

Numbered steps on each language page match this contract. Each page also has a ready Cursor prompt. Skip the SDK with no framework.

  1. 1

    Docker sidecar

    SVEDA_EMBED_ENABLED=true on ghcr.io/neresson/sveda-server plus a host API key. CORS lists the page origin so /build/sveda/sveda-chat.css and sveda-chat.js load.

  2. 2

    Install the SDK

    Or skip it. A static page plus curl or a 20-line mint route is enough.

  3. 3

    Match the keys

    SVEDA_CLIENT_HOST_API_KEY equals SVEDA_EMBED_HOST_API_KEY.

  4. 4

    POST /sveda/session

    Return origin, token, expires_in.

  5. 5

    Open the chat

    Set data-sveda-origin and data-sveda-session, then JS or iframe.

Start without a framework.

Static HTML, an iframe, or a 20-line session endpoint. Then pick a language SDK when you want typed minting.

No framework