API per sviluppatori

Endpoint

• GET /api/trajectory/collective-pulse — Distribuzione anonima dell'umore (nessuna identità).
• GET /api/trajectory/user-arc — Traiettoria dell'utente connesso — solo oggi.
• GET /api/mood/discovery-feed — Card sicure per la scoperta per widget e incorporamenti.
• POST /api/developer/register — Crea una chiave API (richiede una sessione).
• GET /api/council/world-signals — Ultime righe di acquisizione mondiale del Consiglio (riepilogo derivato + collegamenti sorgente; velocità limitata).

API partner (`/api/v1`)

Gli integratori autenticati utilizzano una chiave API portante. Ogni chiamata può addebitare Essence al proprietario della chiave (impostazione predefinita di seguito o `ApiKey.essencePerCall` se impostato). Le risposte sono per uso filosofico/del prodotto con il tuo disclaimer.

• `POST /api/v1/oracle` — Completamento Oracle (predefinito 15 essenze per chiamata).
• `POST /api/v1/mood/analyze` — analisi orientata all'umore (impostazione predefinita 5).
• `GET`/`POST /api/v1/user/memory` — bridge di memoria con ambito (default 10).
• `GET`/`POST`/`DELETE /api/v1/keys` — gestisce le chiavi (sessione; la creazione restituisce la chiave grezza una volta).
• `GET /api/v1/collective` — snapshot collettivo per i widget.
• `GET /api/v1/atlas/moods`: metadati del catalogo degli stati d'animo Atlas.

Modello di prezzi

Essenza: fatturazione opzionale per chiamata tramite ApiKey.essencePerCall (unità in-app, non valuta legale).

I livelli di abbonamento corrispondono alle quote giornaliere sulle rotte di traiettoria — vedi api-gate.

Esempio curl

Impulso collettivo (nessuna autenticazione):

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

Traiettoria utente (cookie di sessione o futuro bearer sui flussi contrattuali):

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
}

Registra una chiave

I risultati sono destinati esclusivamente all'esplorazione filosofica; i prodotti downstream devono mostrare una dichiarazione di non responsabilità equivalente agli utenti finali.