Votre premier appel API,
en trois étapes.

Générer un token public read-only

Depuis l’app Tramya, ouvrez Compte → Clés API et cliquez « Créer un token ». Le token est affiché une seule fois - copiez-le et stockez-le comme un secret.

export TRAMYA_TOKEN="tra_pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Un token public expose uniquement des données agrégées (compteurs, titres, snippets) - jamais le contenu complet des conversations. Il est rotable à tout moment.

Vérifier avec curl

Un ping sur /workspace/status renvoie un JSON avec les compteurs projets / conversations / mémoires. Si vous obtenez 200 OK, votre token est bon.

curl -sS -H "Authorization: Bearer $TRAMYA_TOKEN" \
  https://app.tramya.com/api/v1/public/workspace/status | jq

Choisir votre SDK

Trois clients officiels, zéro dépendance externe côté transport.

npm install @tramya/sdk

import { TramyaClient } from '@tramya/sdk';
const tramya = new TramyaClient({ token: process.env.TRAMYA_TOKEN });
const status = await tramya.workspace.status();
console.log(status);

pip install tramya-sdk

from tramya_sdk import TramyaClient
client = TramyaClient(token="$TRAMYA_TOKEN")
print(client.workspace.status())

go get github.com/arthurferreira64/tramya/sdk/tramya-sdk-go

client, _ := tramya.NewClient(tramya.Config{Token: os.Getenv("TRAMYA_TOKEN")})
status, _ := client.Workspace.Status(ctx)
fmt.Printf("%+v\n", status)