Feed Standard

A feed is a data type that describes a source and collects its items. Like an RSS feed has the name and description of its blog, a WorldAPI feed carries metadata about its origin and groups items from any standard into a single subscribable stream.

Feed Object

{
	$type: 'feed',
	$version: 1,
	$title: 'My Tech Blog',
	$description: 'Notes on software and systems',
	$url: 'https://example.com/feed',
	$language: 'en',
	$icon: 'https://example.com/icon.svg',
	$updated: '2026-03-29 14:00:00',
	$items: [
		{
			$type: 'message',
			$kind: 'message',
			$body: 'Just published the new API docs!',
			$from: { $name: 'Jane Doe' },
			$created: '2026-01-15 12:07:58'
		},
		{
			$type: 'location',
			$kind: 'point',
			$name: 'API Conference 2026',
			$lat: 48.20849,
			$lng: 16.37308,
			$created: '2026-03-10 08:00:00'
		},
		{
			$type: 'filesystem',
			$kind: 'file',
			$name: 'api-docs-v2.pdf',
			$mime: 'application/pdf',
			$size: 284160,
			$created: '2026-03-25 14:00:00'
		}
	]
}

Each item in $items is a WorldAPI object with its own $type. A feed can mix types freely.

Feed Properties

Items in a feed are regular WorldAPI objects. Each item's properties are defined by its own $type standard (location, filesystem, message, etc.).