Kehittäjä-API

Päätepisteet

• GET /api/trajectory/collective-pulse — Anonyymi mielialajakauma (ei identiteettejä).
• GET /api/trajectory/user-arc — Kirjautuneen käyttäjän kehityskäyrä – vain itse tänään.
• GET /api/mood/discovery-feed — Turvalliset kortit widgeteille ja upotuksille.
• POST /api/developer/register — Luo API-avain (vaatii istunnon).
• GET /api/council/world-signals — Viimeisimmät neuvoston maailmanlaajuisesti kerätyt rivit (johdannaiset yhteenvedot + lähdelinkit; rajoitettu määrä).

Partner API (`/api/v1`)

Autentikoidut integraattorit käyttävät siirtotie-API-avainta. Jokainen puhelu voi veloittaa Essenceä avaimen omistajalta (oletusarvot alla tai "ApiKey.essencePerCall", kun se on asetettu). Vastaukset on tarkoitettu filosofiseen/tuotekäyttöön oman vastuuvapauslausekkeen kanssa.

• "POST /api/v1/oracle" — Oraclen valmistuminen (oletusarvo 15 Essenceä puhelua kohti).
• `POST /api/v1/mood/analyze` — mielialalähtöinen analyysi (oletus 5).
• "GET"/"POST /api/v1/user/memory" — laajennettu muistisilta (oletus 10).
• `GET`/`POST`/`DELETE /api/v1/keys` — hallitse avaimia (istunto; luonti palauttaa raakaavaimen kerran).
• `GET /api/v1/collective` – yhteinen tilannekuva widgeteistä.
• "GET /api/v1/atlas/moods" — Atlas-tunnelmaluettelon metatiedot.

Hinnoittelumalli

Essence: valinnainen per-kutsu-veloitus ApiKey.essencePerCall:n kautta (sovelluksen sisäinen yksikkö, ei laillinen maksuväline).

Jäsenyystasot vastaavat päivittäisiä kiintiöitä kehityskäyräreiteille – katso api-gate.

Esimerkki curl-komennosta

Kollektiivinen pulssi (ei autentikointia):

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

Käyttäjän kehityskäyrä (istuntokeksit tai tuleva bearer sopimusperusteisissa virroissa):

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
}

Rekisteröi avain

Tulosteet on tarkoitettu vain filosofiseen pohdintaan; lopputuotteissa on näytettävä vastaava vastuuvapauslauseke loppukäyttäjille.