Services/Sync/Server/Archived/0.3/API

From MozillaWiki
< Services‎ | Sync‎ | Server‎ | Archived
Revision as of 00:03, 8 October 2008 by Telliott (talk | contribs) (New page: = Weave 0.3 API = Release Date: TBD = Weave Basic Object (WBO) = A Weave Basic Object is the generic wrapper around all items passed into and out of the Weave server. The Weave Basic Obje...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Weave 0.3 API

Release Date: TBD

Weave Basic Object (WBO)

A Weave Basic Object is the generic wrapper around all items passed into and out of the Weave server. The Weave Basic Object has the following fields:


Parameter Default Description
type required The type of object contained in the WBO payload. Each type has a defined structure associated with it, beginning with "object". Valid object subtypes, if used, are "cryptowrapper" (whch should be used for all WBOs that have an encrypted payload) or the object type as defined in the payload (optional). Types are hierarchical arrays, beginning with the "object" type.
id required An identifying string. For a user, the id must be unique for a WBO within a collection, though objects in different collections may have the same ID.
parent none The id of a parent object in the same collection. This allows for the creation of hierarchical structures (such as folders).
modified time submitted The last-modified date, in Julian date format.
encryption none The URL of a Weave Encryption Record (WER) that defines how the payload is encrypted. No URL means that the payload is being sent unencrypted.
encoding utf-8 The character set of the decrypted payload.

payload (required) - The (possibly encrypted) JSON structure encapsualting the data of the record. This structure is defined separately for each WBO type.