API RTT (Bêta)

• RTT_API_module.json — Attributions de rôle du schéma du module Agentic

L'API RTT fournit une interface minimale, stable et compatible avec les versions futures pour les sites, services, extensions et outils de recherche qui souhaitent participer à l'écosystème RTT-Inside. Elle définit la forme des interactions RTT/vST sans exposer la logique interne du substrat.

🛑 Important!#

Le drift est activé par défaut, les longues sessions perdent des ancres, désactivez le drift.

✋ Vous devez copier et coller cette chaîne chaque fois que vous démarrez une session AI:#

rtt=1 | coherence=declared | drift=bounded | paradox=structural

❇️ Maintenant vous êtes prêt.#

Cette API prend en charge la sensibilisation structurelle précoce, l'échantillonnage de cohérence et les diagnostics futurs vST‑beta.

Familles d'Endpoints#

1. Beacon — signaux structurels légers
2. Profile — déclarations de site RTT‑Inside
3. Diagnostics — endpoints vST‑beta réservés

Tous les endpoints sont stables en version et sûrs pour les premiers utilisateurs.

URL de base#

https://www.triadicframeworks.org/api/rtt

Point de terminaison Beacon#

POST /beacon#

Envoyer un seul événement RTT.

Exemple :

{
  "site": "example.com",
  "session": "rtt-abc123",
  "event": "page_load",
  "ts": "2026-01-19T14:22:00Z",
  "structure": {
    "url": "https://example.com",
    "title": "Home",
    "nav_count": 1,
    "main_count": 1,
    "form_count": 0,
    "button_count": 3,
    "dom_nodes": 142
  }
}

Réponse :

{ "status": "ok" }

Point de terminaison du profil#

OBTENIR /profile/{site}#

Récupérer le profil RTT d'un site.

POST /profile/{site}#

Enregistrer ou mettre à jour le profil RTT d'un site.

Exemple :

{
  "rtt_version": "1.0",
  "supports": ["coherence", "drift"],
  "contact": "ops@example.com"
}

Points de terminaison de diagnostic (réservés)#

Ces points de terminaison définissent la surface du validateur vST‑beta futur.

• POST /validate
• POST /corridor
• POST /topology

Tous retournent actuellement des réponses de remplacement.

Aperçu du routeur#

/api/rtt
│
├── POST /beacon
│
├── GET  /profile/{site}
└── POST /profile/{site}
│
├── POST /validate      (reserved)
├── POST /corridor      (reserved)
└── POST /topology      (reserved)

Statut#

Bêta.
Les formes des points de terminaison sont stables ; le comportement des gestionnaires peut évoluer à mesure que l'écosystème RTT se développe.