開発者 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 — 最新の Council world-ingest 行 (派生的な概要 + ソース リンク、レート制限あり)。

パートナー 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` — キーを管理します (セッション。作成時に生のキーが 1 回返されます)。
• `GET /api/v1/collective` — ウィジェットの集合スナップショット。
• `GET /api/v1/atlas/moods` — アトラス ムード カタログのメタデータ。

料金モデル

エッセンス: ApiKey.essencePerCall を介したオプションの従量課金（アプリ内ユニット、法的通貨ではありません）。

メンバーシップティアは、軌跡ルートの毎日のクォータにマッピングされます — api-gate を参照してください。

例: curl

集合的なパルス（認証なし）：

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

ユーザー軌跡（セッションクッキーまたは契約されたフローの将来のベアラ）：

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
}

キーを登録

出力は哲学的な探求のみを目的としています。下流製品は、エンドユーザーに対して同等の免責事項を表示する必要があります。