Entwickler-API

Endpunkte

• GET /api/trajectory/collective-pulse — Anonyme Stimmungsverteilung (keine Identitäten).
• GET /api/trajectory/user-arc — Trajektorie eines angemeldeten Benutzers – nur für heute.
• GET /api/mood/discovery-feed — Discovery-sichere Karten für Widgets und Einbettungen.
• POST /api/developer/register — Erstellt einen API-Schlüssel (erfordert Sitzung).
• GET /api/council/world-signals — Neueste World-Ingest-Zeilen des Rates (abgeleitete Zusammenfassungen + Quellenlinks; ratenbegrenzt).

Partner-API (`/api/v1`)

Authentifizierte Integratoren verwenden einen Bearer-API-Schlüssel. Jeder Anruf kann Essence vom Schlüsseleigentümer belasten (Standardeinstellungen unten oder „ApiKey.essencePerCall“, wenn festgelegt). Die Antworten dienen der philosophischen / produktbezogenen Verwendung mit Ihrem eigenen Haftungsausschluss.

• „POST /api/v1/oracle“ – Oracle-Vervollständigung (Standard 15 Essence pro Aufruf).
• „POST /api/v1/mood/analyze“ – stimmungsorientierte Analyse (Standard 5).
• „GET“/„POST /api/v1/user/memory“ – begrenzte Speicherbrücke (Standard 10).
• `GET`/`POST`/`DELETE /api/v1/keys` – Schlüssel verwalten (Sitzung; Erstellung gibt den Rohschlüssel einmal zurück).
• „GET /api/v1/collective“ – kollektiver Snapshot für Widgets.
• „GET /api/v1/atlas/moods“ – Metadaten des Atlas-Stimmungskatalogs.

Preismodell

Essenz: optionale Abrechnung pro Aufruf über ApiKey.essencePerCall (In-App-Einheit, kein gesetzliches Zahlungsmittel).

Mitgliedschaftsstufen entsprechen täglichen Kontingenten für Trajektorienrouten – siehe api-gate.

Beispiel-curl

Kollektiver Puls (keine Authentifizierung):

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

Benutzertrajektorie (Sitzungscookie oder zukünftiger Bearer in vertraglichen Flows):

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
}

Schlüssel registrieren

Die Ausgaben dienen nur der philosophischen Erkundung; nachgelagerte Produkte müssen einen entsprechenden Haftungsausschluss für Endbenutzer anzeigen.