API para desarrolladores

Puntos finales

• GET /api/trajectory/collective-pulse — Distribución anónima del estado de ánimo (sin identidades).
• GET /api/trajectory/user-arc — Arco del usuario conectado: solo el propio usuario de hoy.
• GET /api/mood/discovery-feed — Tarjetas seguras para el descubrimiento para widgets e inserciones.
• POST /api/developer/register — Crea una clave API (requiere sesión).
• GET /api/council/world-signals — Últimas filas de ingesta mundial del Consejo (resúmenes de derivados + enlaces de fuentes; velocidad limitada).

API de socio (`/api/v1`)

Los integradores autenticados utilizan una clave API portadora. Cada llamada puede debitar Essence del propietario de la clave (los valores predeterminados se indican a continuación, o `ApiKey.essencePerCall` cuando está configurado). Las respuestas son para uso filosófico/de producto con su propio descargo de responsabilidad.

• `POST /api/v1/oracle`: finalización de Oracle (predeterminado, 15 esencias por llamada).
• `POST /api/v1/mood/analyze` — análisis orientado al estado de ánimo (predeterminado 5).
• `GET`/`POST /api/v1/user/memory`: puente de memoria con alcance (predeterminado 10).
• `GET`/`POST`/`DELETE /api/v1/keys`: administra claves (sesión; la creación devuelve la clave sin formato una vez).
• `GET /api/v1/collective` — instantánea colectiva para widgets.
• `GET /api/v1/atlas/moods` — Metadatos del catálogo de estados de ánimo de Atlas.

Modelo de precios

Esencia: facturación opcional por llamada a través de ApiKey.essencePerCall (unidad dentro de la aplicación, no moneda legal).

Los niveles de membresía se asignan a cuotas diarias en las rutas de trayectoria: consulte api-gate.

Ejemplo de curl

Pulso colectivo (sin autenticación):

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

Arco del usuario (cookie de sesión o futuro portador en flujos contratados):

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
}

Registrar una clave

Las salidas son solo para exploración filosófica; los productos posteriores deben mostrar un descargo de responsabilidad equivalente a los usuarios finales.