개발자 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 세계 수집 행(파생 요약 + 소스 링크, 속도 제한)

파트너 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"

사용자 궤적 (세션 쿠키 또는 계약된 흐름의 향후 베어러):

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
}

API 키 등록

출력은 철학적 탐구만을 위한 것이며, 다운스트림 제품은 최종 사용자에게 동등한 면책 조항을 표시해야 합니다.