API dành cho nhà phát triển

Điểm cuối

• GET /api/trajectory/collective-pulse — Phân phối tâm trạng ẩn danh (không có danh tính).
• GET /api/trajectory/user-arc — Quỹ đạo người dùng đã đăng nhập — chỉ bản thân hôm nay.
• GET /api/mood/discovery-feed — Các thẻ an toàn cho việc khám phá để sử dụng trong các widget và nhúng.
• POST /api/developer/register — Tạo khóa API (yêu cầu phiên).
• GET /api/council/world-signals — Các hàng cập nhật thế giới mới nhất của Hội đồng (tóm tắt phái sinh + liên kết nguồn; tỷ lệ giới hạn).

API đối tác (`/api/v1`)

Các nhà tích hợp được xác thực sử dụng khóa API mang. Mỗi cuộc gọi có thể ghi nợ Essence từ chủ sở hữu khóa (mặc định bên dưới hoặc `ApiKey.essencePerCall` khi được đặt). Các câu trả lời dành cho mục đích sử dụng triết học/sản phẩm với tuyên bố từ chối trách nhiệm của riêng bạn.

• `POST /api/v1/oracle` — Hoàn thành Oracle (mặc định 15 Essence cho mỗi lệnh gọi).
• `POST /api/v1/mood/analyze` — phân tích theo tâm trạng (mặc định 5).
• `GET`/`POST /api/v1/user/memory` — cầu bộ nhớ có phạm vi (mặc định là 10).
• `GET`/`POST`/`DELETE /api/v1/keys` — quản lý khóa (phiên; quá trình tạo trả về khóa thô một lần).
• `GET /api/v1/collective` — ảnh chụp nhanh chung cho các widget.
• `GET /api/v1/atlas/moods` — Siêu dữ liệu danh mục tâm trạng của Atlas.

Mô hình giá

Essence: thanh toán theo mỗi lần gọi tùy chọn thông qua ApiKey.essencePerCall (đơn vị trong ứng dụng, không phải tiền tệ hợp pháp).

Các cấp độ thành viên tương ứng với hạn mức hàng ngày trên các tuyến đường quỹ đạo — xem api-gate.

Ví dụ curl

Xung động tập thể (không cần xác thực):

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

Quỹ đạo người dùng (cookie phiên hoặc bearer trong tương lai trên các luồng đã ký hợp đồng):

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
}

Đăng ký khóa API

Kết quả chỉ dành cho mục đích khám phá triết học; các sản phẩm hạ nguồn phải hiển thị tuyên bố từ chối trách nhiệm tương đương cho người dùng cuối.