Geliştirici API

Uç noktalar

• GET /api/trajectory/collective-pulse — Anonim ruh hali dağılımı (kimlik yok).
• GET /api/trajectory/user-arc — Oturum açmış kullanıcının yörüngesi — şimdilik yalnızca kendi veriniz.
• GET /api/mood/discovery-feed — Gömülebilir arayüzler için güvenli keşif kartları.
• POST /api/developer/register — API anahtarı üretir (oturum gerekir).
• GET /api/council/world-signals — Konsey dünya ingest kayıtları — özet + kaynak bağlantıları (hız sınırlı).

Ortak API (`/api/v1`)

Entegratörler bearer API anahtarı kullanır. Her çağrı anahtar sahibinin Essence bakiyesinden düşülebilir (aşağıdaki varsayılanlar veya ayarlı `ApiKey.essencePerCall`). Çıktılar kendi sorumluluğunuzda ürün/felsefi kullanım içindir; uç kullanıcıya uyarı gösterin.

• `POST /api/v1/oracle` — Oracle tamamlama (varsayılan çağrı başı 15 Essence).
• `POST /api/v1/mood/analyze` — mood odaklı analiz (varsayılan 5).
• `GET`/`POST /api/v1/user/memory` — kapsamlı hafıza köprüsü (varsayılan 10).
• `GET`/`POST`/`DELETE /api/v1/keys` — anahtar yönetimi (oturum; oluşturma ham anahtarı bir kez döner).
• `GET /api/v1/collective` — widget’lar için kolektif özet.
• `GET /api/v1/atlas/moods` — Atlas mood kataloğu meta verisi.

Fiyatlandırma modeli

Essence: ApiKey.essencePerCall ile isteğe bağlı çağrı başı ücret (uygulama içi birim).

Üyelik kademeleri yörünge rotalarında günlük kotaya bağlanır — api-gate.

Örnek curl

Kolektif nabız (kimlik doğrulamasız):

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

Kullanıcı yörüngesi (oturum çerezi veya sözleşmeli akışlarda 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
}

Anahtar oluştur

Çıktılar yalnızca felsefi keşif içindir; kendi kullanıcılarınıza gösterirken eşdeğer bir uyarı metni zorunludur.