Technical Paper

05 — Data Schema and API

This section defines Yumo Yumo's public schema and API surface. Pipeline outputs in 02, trust decisions in 03, and reward accounting in 04 map to the entity and event shapes defined here.

Schemas are published so protocol parties can read the same record in the same way. Physical indexing strategy, provider choice, hot/cold data movement, and commercial parameters of the B2B product remain in operational documentation.

5.0 Schema Principle

PrincipleConsequence
Typed recordEvery public object is versioned and schema-bound
Event-based ledgerReward accounting is derived from auditable historical events
Separated dataPersonal data, aggregate data, and on-chain summary live in separate layers
Versionable APIField additions/removals follow backward-compatibility rules