GnoosiS

Appearance

API Reference ​

GnoosiS is a client application built on Flutter and Firebase, with a set of backend REST endpoints handling logic that doesn't belong on-device — feed ranking, ad serving, and payment processing. This page describes that surface at a conceptual level; it is not a public developer SDK.

Not a public integration API

Unlike Aephoron's identity SDKs, GnoosiS does not currently expose a public API for third-party developers. This reference documents the internal shape of the backend for context, not as an invitation to integrate directly.

Feed & content ​

Endpoints backing Fama, Glossa, and Diavasi read and write through Firestore, fronted by REST endpoints for operations that need server-side logic (ranking, moderation, fan-out):

  • POST /v1/posts — create a Fama post or Glossa update
  • GET /v1/feed — fetch a ranked feed page (trending, following, or discovery)
  • POST /v1/reels — publish a Diavasi video with shoppable tags
  • POST /v1/posts/:id/like, POST /v1/posts/:id/comment — engagement actions

Chat ​

Messaging is primarily real-time via Firestore listeners and Cloud Messaging push, with REST used for setup and moderation:

  • POST /v1/chat/threads — start a 1:1 or group thread
  • POST /v1/chat/threads/:id/messages — send a message (payload is end-to-end encrypted client-side before it reaches this endpoint)
  • POST /v1/stories — publish a 24h ephemeral story

Wallet & payments ​

  • GET /v1/wallet/balance — DracmaS (DMS) balance for the authenticated user
  • POST /v1/wallet/transfer — P2P DracmaS transfer by nickname or QR
  • POST /v1/payments/topup — fiat top-up via Stripe or PayPal
  • POST /v1/payments/kyc — submit KYC information for verification

Ads (Adsxx) ​

  • GET /v1/ads/serve — request an ad placement (banner, native in-feed, rewarded)
  • POST /v1/ads/proof-of-view — report engagement signals (view time, screen percentage, interaction) used by the Proof of View system to validate genuine ad views
  • GET /v1/ads/campaigns/:id/performance — advertiser-facing campaign metrics

Authentication ​

All endpoints require a Firebase Authentication ID token:

bash
Authorization: Bearer <firebase-id-token>

For security practices around tokens, KYC data, and chat encryption, see the Privacy & Security guide.