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` — метаданные каталога настроений Атласа.

Ценовая модель

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
}

Зарегистрировать ключ

Результаты предназначены только для философских исследований; конечные продукты должны отображать эквивалентный отказ от ответственности для конечных пользователей.