API προγραμματιστών

Καταληκτικά σημεία

• GET /api/trajectory/collective-pulse — Ανωνύμη διανομή διάθεσης (χωρίς ταυτότητες).
• GET /api/trajectory/user-arc — Τροχιά συνδεδεμένου χρήστη — μόνο για σήμερα.
• GET /api/mood/discovery-feed — Κάρτες ασφαλείς για ανακάλυψη για widgets και ενσωματώσεις.
• POST /api/developer/register — Δημιουργεί ένα κλειδί API (απαιτεί συνεδρία).
• GET /api/council/world-signals — Τελευταίες σειρές παγκόσμιας απορρόφησης του Συμβουλίου (περιλήψεις παραγώγων + σύνδεσμοι πηγής, περιορισμένη τιμή).

Partner API (`/api/v1`)

Οι πιστοποιημένοι ολοκληρωτές χρησιμοποιούν ένα κλειδί API φορέα. Κάθε κλήση μπορεί να χρεώσει το 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` — Μεταδεδομένα καταλόγου διάθεσης Atlas.

Μοντέλο τιμολόγησης

Essence: προαιρετική χρέωση ανά κλήση μέσω ApiKey.essencePerCall (μονάδα εντός εφαρμογής, όχι νόμιμο χρήμα).

Τα επίπεδα συνδρομής αντιστοιχούν σε ημερήσιες ποσοστώσεις στις διαδρομές τροχιάς — δείτε api-gate.

Παράδειγμα curl

Συλλογική παρόρμηση (χωρίς έλεγχο ταυτότητας):

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

Τροχιά χρήστη (cookie συνεδρίας ή μελλοντικός φορέας σε συμφωνημένες ροές):

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
}

Εγγραφή κλειδιού

Οι έξοδοι προορίζονται μόνο για φιλοσοφική εξερεύνηση· τα προϊόντα downstream πρέπει να εμφανίζουν μια ισοδύναμη αποποίηση ευθύνης στους τελικούς χρήστες.