واجهة برمجة تطبيقات للمطورين

نقاط النهاية

• 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/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`` — لقطة جماعية للأدوات.
• `الحصول على /api/v1/atlas/moods` - البيانات الوصفية لكتالوج Atlas المزاجي.

نموذج التسعير

جوهر: فوترة اختيارية لكل مكالمة عبر 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
}

تسجيل مفتاح

المخرجات مخصصة للاستكشاف الفلسفي فقط؛ يجب أن تعرض المنتجات النهائية إخلاء مسؤولية مماثلاً للمستخدمين النهائيين.