开发者 API

端点

• GET /api/trajectory/collective-pulse — 匿名情绪分布（无身份信息）。
• GET /api/trajectory/user-arc — 已登录用户轨迹——仅限今天。
• GET /api/mood/discovery-feed — 适用于小部件和嵌入的发现安全卡片。
• POST /api/developer/register — 创建 API 密钥（需要会话）。
• GET /api/council/world-signals — 最新的理事会世界摄取行（衍生摘要+源链接；速率有限）。

合作伙伴 API (`/api/v1`)

经过身份验证的集成商使用不记名 API 密钥。 每次调用都可以从密钥所有者处扣除 Essence（默认值如下，或设置后的“ApiKey.essencePerCall”）。 回复仅供哲学/产品使用，并带有您自己的免责声明。

• `POST /api/v1/oracle` — Oracle 完成（每次调用默认 15 个精华）。
• `POST /api/v1/mood/analyze` — 面向情绪的分析（默认 5）。
• `GET`/`POST /api/v1/user/memory` — 作用域内存桥（默认 10）。
• `GET`/`POST`/`DELETE /api/v1/keys` — 管理密钥（会话；创建时返回原始密钥一次）。
• `GET /api/v1/collective` — 小部件的集体快照。
• `GET /api/v1/atlas/moods` — Atlas 情绪目录元数据。

定价模式

Essence：通过 ApiKey.essencePerCall 进行可选的按调用计费（应用内单位，而非法定货币）。

会员等级映射到轨迹路由的每日配额——请参阅 api-gate。

示例 curl

集体脉搏（无需身份验证）：

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

用户轨迹（会话 Cookie 或未来合约流程中的 bearer）：

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
}

注册密钥

输出仅供哲学探索使用；下游产品必须向最终用户显示同等免责声明。