API para Desenvolvedores

Pontos finais

• GET /api/trajectory/collective-pulse — Distribuição anônima de humor (sem identificação).
• GET /api/trajectory/user-arc — Trajetória do usuário logado — apenas para o próprio usuário, hoje.
• GET /api/mood/discovery-feed — Cards seguros para descoberta em widgets e incorporações.
• POST /api/developer/register — Cria uma chave de API (requer sessão).
• GET /api/council/world-signals — Últimas linhas de ingestão mundial do Conselho (resumos derivados + links de fontes; taxa limitada).

API de parceiro (`/api/v1`)

Os integradores autenticados usam uma chave de API de portador. Cada chamada pode debitar Essence do proprietário da chave (padrões abaixo ou `ApiKey.essencePerCall` quando definido). As respostas são para uso filosófico/do produto com sua própria isenção de responsabilidade.

• `POST /api/v1/oracle` — Conclusão do Oracle (padrão 15 Essências por chamada).
• `POST /api/v1/mood/analyze` — análise orientada ao humor (padrão 5).
• `GET`/`POST /api/v1/user/memory` — ponte de memória com escopo (padrão 10).
• `GET`/`POST`/`DELETE /api/v1/keys` — gerencia chaves (sessão; criação retorna chave bruta uma vez).
• `GET /api/v1/collective` — instantâneo coletivo para widgets.
• `GET /api/v1/atlas/moods` — Metadados do catálogo de humor do Atlas.

Modelo de preços

Essência: cobrança opcional por chamada via ApiKey.essencePerCall (unidade do app, não moeda legal).

Níveis de assinatura mapeiam para cotas diárias em rotas de trajetória — veja api-gate.

Exemplo em curl

Pulso coletivo (sem autenticação):

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

Trajetória do usuário (cookie de sessão ou futuro 'bearer' em fluxos 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
}

Cadastre uma chave

As saídas são apenas para exploração filosófica; produtos derivados devem exibir um aviso legal equivalente aos usuários finais.