API publique v1 | Read-only
Consultez votre espace
depuis n’importe où.
7 endpoints REST pour alimenter un dashboard interne, un outil de veille, ou l’app Tramya Mobile. Authentification par token Bearer rotable, rate-limité, sans exposition de contenu privé au-delà d’un snippet de 200 caractères.
Getting started
Trois étapes pour votre première requête.
- Créez un token dans /admin, section « Clés API v1 ». Choisissez ses scopes (billing:read, cloud:read, workspace:read, projects:read) et notez le secret immédiatement - il ne sera plus jamais affiché.
- Passez-le en header Bearer :
Authorization: Bearer tra_pk_xxx. Le préfixetra_pk_est constant. Le reste est aléatoire (192 bits). - Appelez les endpoints. Voir la référence ci-dessous ou téléchargez la spec OpenAPI pour générer un client dans votre langage.
Référence
7 endpoints, tous en lecture.
Plan actif, features débloquées, catalogue Stripe (IDs masqués).
curl -H "Authorization: Bearer $TRAMYA_TOKEN" \ https://app.tramya.com/api/v1/public/billing/status
Connexion Cloud du compagnon local, dernier backup, ID compte masqué.
Stats globales : nombre de projets, conversations, messages, tokens, mémoires, checkpoints, sources.
Liste complète des projets avec nom, description, compteurs. Sans chemin filesystem.
Métadonnées des conversations récentes. Zéro contenu de message. Filtres ?projectId= et ?limit= (1-100).
Mémoires enregistrées, snippet 200 caractères, tags. Filtres ?projectId= et ?limit=.
Recherche full-text sur mémoires, checkpoints et messages. Rate-limité 30/min par token. Query minimum 2 caractères. Snippet 200 chars.
curl -H "Authorization: Bearer $TRAMYA_TOKEN" \ "https://app.tramya.com/api/v1/public/search?q=stripe"
Sécurité et limites
Ce que vous n’exposerez jamais avec cette API.
- Le contenu complet d’une conversation ou d’une mémoire (jamais retourné, seul un snippet de 200 caractères pour
/searchet/memories). - Les chemins filesystem locaux (nettoyés des réponses).
- Les IDs Stripe complets (masqués : 4 premiers + 4 derniers caractères).
- Les secrets, jetons cloud, ou informations de session.
Pour extraire l’intégralité de vos données, utilisez plutôt l’export local depuis l’application Tramya - la Public API v1 n’est pas conçue pour ça.