API Développeur

Points de terminaison

• GET /api/trajectory/collective-pulse — Distribution anonyme de l'humeur (sans identités).
• GET /api/trajectory/user-arc — Trajectoire de l'utilisateur connecté — uniquement pour l'utilisateur actuel aujourd'hui.
• GET /api/mood/discovery-feed — Cartes compatibles avec la découverte pour les widgets et les intégrations.
• POST /api/developer/register — Crée une clé API (nécessite une session).
• GET /api/council/world-signals — Dernières lignes d'absorption mondiale du Conseil (résumés dérivés + liens sources ; débit limité).

API partenaire (`/api/v1`)

Les intégrateurs authentifiés utilisent une clé API porteur. Chaque appel peut débiter Essence du propriétaire de la clé (valeurs par défaut ci-dessous, ou `ApiKey.essencePerCall` lorsqu'il est défini). Les réponses sont destinées à un usage philosophique/produit avec votre propre clause de non-responsabilité.

• `POST /api/v1/oracle` — Achèvement Oracle (par défaut 15 Essences par appel).
• `POST /api/v1/mood/analyze` — analyse orientée humeur (par défaut 5).
• `GET`/`POST /api/v1/user/memory` — pont de mémoire étendu (par défaut 10).
• `GET`/`POST`/`DELETE /api/v1/keys` — gérer les clés (session ; la création renvoie la clé brute une fois).
• `GET /api/v1/collective` — instantané collectif pour les widgets.
• `GET /api/v1/atlas/moods` — Métadonnées du catalogue d'ambiances Atlas.

Modèle de tarification

Essence : facturation facultative par appel via ApiKey.essencePerCall (unité intégrée, pas monnaie légale).

Les niveaux d'adhésion correspondent aux quotas quotidiens sur les routes de trajectoire — voir api-gate.

Exemple curl

Pouls collectif (sans authentification) :

curl -sS "http://essentiamemoria.com/api/trajectory/collective-pulse"

Trajectoire utilisateur (cookie de session ou futur bearer sur les flux contractuels) :

curl -sS "http://essentiamemoria.com/api/trajectory/user-arc" -H "Cookie: your_session=…"

Spawn 3D Objects via Webhook

POST a payload to /api/v1/world/spawn with your API key to instantly materialize objects inside the Essentia cosmos. Requires a key with write or * scope.

curl -sS -X POST "http://essentiamemoria.com/api/v1/world/spawn" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "event",
  "title": "Product Launch",
  "description": "Our new feature is live!",
  "moodTarget": "7",
  "layerTarget": 3,
  "durationHours": 48
}'

{
  "ok": true,
  "objectId": "cm...",
  "type": "event",
  "title": "Product Launch",
  "expiresAt": "2026-05-16T12:00:00.000Z",
  "position": "cosmos_event_node",
  "moodTarget": "7",
  "layerTarget": 3
}

Enregistrer une clé

Les résultats sont destinés à l'exploration philosophique uniquement ; les produits dérivés doivent afficher un avertissement équivalent aux utilisateurs finaux.