I/O projection contract

Calendar data without heavyweight clients.

Super-Calendar I/O exposes stable nodes from calendar resources as plain text, tables, rows, columns, cells, JSON, CSV, TSV, and NDJSON. A device can read one forecast line without parsing the whole API response.

Full API

Full JSON, ICS, or app-facing response.

Node I/O

One table, row, column, field, or cell in a simple format.

Shared runtime

The same source can feed docs, status checks, calendar previews, and low-level clients.

Addressing

One resolver, predictable paths.

Address	Type	Meaning
`/api/weather/io`	root	Manifest for one resource.
`/api/weather/io/events`	table	Events table.
`/api/weather/io/events/1`	row	First event row. Indexes start at 1.
`/api/weather/io/events/summary.txt`	column	All event summaries as text lines.
`/api/weather/io/events/1/summary.txt`	cell	One event summary as text.
`/api/weather/io/meta/calendarDesc.txt`	field	One metadata field.

Formats

Suffixes for clients that cannot negotiate headers.

txt json csv tsv ndjson

Resources

Examples generated from the I/O manifest.

⛅ Weather

Calendar nodes for weather forecasts.

/api/weather/io/events/summary.txt?city=Sao%20Paulo&units=metric&lang=pt-BR&emoji=true

events table
events/summary column txt, json, csv, tsv
meta/calendarDesc field txt, json

Open example Feed page

💱 Exchange

Calendar nodes for exchange rates.

/api/exchange/io/events/summary.txt?base=USD&target=BRL&lang=pt-BR&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example Feed page

🌙 Moon

Calendar nodes for moon phases.

/api/moon/io/events/summary.txt?lang=en&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example Feed page

🌐 Seasons

Calendar nodes for solstices, equinoxes, and seasonal changes.

/api/seasons/io/events/summary.txt?year=2026&hemisphere=south&lang=pt-BR&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example

🛐 Religion

Calendar nodes for religious dates.

/api/religion/io/events/summary.txt?religion=christianity&lang=en&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example Feed page

🔄 Events

Calendar nodes for recurring events.

/api/events/io/events/summary.txt?year=2026&periodic=01&studies=05&rent=10&lang=pt-BR&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example

📅 Custom calendars

Calendar nodes for fully custom events.

/api/custom/io/events/summary.txt?lang=pt-BR&name=Dias&Counter-Day=%7B%22day%22%3A20%2C%22month%22%3A2%2C%22name%22%3A%22Counter-day%22%7D

events table
events/summary column txt, json, csv, tsv

Open example

📆 Holidays

Calendar nodes for national, regional, and municipal holidays.

/api/holidays/io/events/summary.txt?country=BR&year=2026&lang=pt-BR&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example

💬 Languages

Calendar nodes for daily lexical language entries.

/api/languages/io/events/summary.txt?language=en&set=100&lang=en&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example

📈 Crypto

Calendar nodes for cryptocurrency market data.

/api/crypto/io/events/summary.txt?ids=bitcoin&vs=brl&lang=pt-BR&tz=-3&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example

📊 Earnings

Calendar nodes for company earnings.

/api/earnings/io/events/summary.txt?symbol=GOOGL&lang=en&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example

🏆 Sports

Calendar nodes for sports fixtures and results.

/api/sports/io/events/summary.txt?sport=volleyball&mode=games&lang=en&emoji=true

events table
events/summary column txt, json, csv, tsv

Open example

Shared snapshot

Use one source for docs, status, and calendar tests.

The test calendar should serve a real fixture-backed ICS instead of fan-out requests. That keeps docs deterministic and avoids accidental provider cost.

/api/super-node/scn_7c7db0f8b8b84f3ca57e25f9/calendar.ics

Open calendar test Open snapshot ICS