डेवलपर 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/v1`)

प्रमाणित इंटीग्रेटर्स एक बियरर एपीआई कुंजी का उपयोग करते हैं। प्रत्येक कॉल कुंजी स्वामी से Essence को डेबिट कर सकती है (नीचे डिफ़ॉल्ट, या सेट होने पर `ApiKey.essencePerCall`)। प्रतिक्रियाएँ आपके अपने अस्वीकरण के साथ दार्शनिक/उत्पाद उपयोग के लिए हैं।

• `POST /api/v1/oracle` - Oracle पूर्णता (डिफ़ॉल्ट 15 Essence प्रति कॉल)।
• `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` - एटलस मूड कैटलॉग मेटाडेटा।

मूल्य निर्धारण मॉडल

सार: ApiKey.essencePerCall के माध्यम से प्रति-कॉल बिलिंग (इन-ऐप यूनिट, कानूनी मुद्रा नहीं)।

सदस्यता स्तर प्रक्षेपवक्र मार्गों पर दैनिक कोटा के लिए मैप करते हैं — api-gate देखें।

उदाहरण कर्ल

सामूहिक स्पंदन (कोई प्रमाणीकरण नहीं):

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
}

एक कुंजी पंजीकृत करें

आउटपुट केवल दार्शनिक अन्वेषण के लिए हैं; डाउनस्ट्रीम उत्पादों को अंतिम उपयोगकर्ताओं को एक समान अस्वीकरण दिखाना होगा।