Listings

Listings contain a list of events. Please see here about how they work.

Location
Example
Location
<static host>/projects/<first two chars of project UUID>/<project UUID>/listings.json
Example
https://example.com/projects/3e/3e8841cf-0249-4599-a411-fcc9e09ab476/listings.json

Data

  • project objects contains a project data

    • uuid project UUID

    • app_skin link to the skin (string, optional)

    • app_settings URL to the application project-level settings JSON file without schema, i.e. //example.com/settings.json (string, optional)

    • audio_sync_default_delay all content will be delayed by this many seconds for clients which do not explicitly set audio delay

    • audio_sync_max_delay this is maximum delay value The App is allowed to set

    • tracking_id google analytics id to track user actions on client-side (string)

    • embed project embed url without schema, i.e. //example.com/app.html?bc=l-f0c88d5d-6050-47c9-9573-3071a18fefd7&sh=d3vtzxnppyvur.cloudfront.net (string)

    • history_ignore how long in seconds from the start of event there's no need to read data from CDN/history (because data exists in enmasse cache) (integer)

    • is_localisation_supported flag indicates whether the localisation is enabled or not (boolean)

    • locales list of locales enabled in the project (array)

  • events array of event objects

    • id event UUID

    • name event name (string)

    • start_at event start time, unix timestamp (integer)

    • start_at_iso event start time in ISO format (string)

    • end_at event end time, unix timestamp (integer)

    • end_at_iso event end time in ISO format (string)

    • started flag indicates whether event started or not (boolean)

    • image_url URL to the event image without schema, i.e. //example.com/image.jpg (string)

    • custom_fields object with event's custom fileds in format of key-value

    • digest hash digest of an event data. If something changes digest will change as well.

    • extra_time seconds after episode when client uses data in enmasse cache rather than CDN (integer)

  • assets object with assets exported by service, where key is a service type and value is an array of assets. For details about assets format see Assets.

{
"project": {
"uuid": "402f23e5-24fe-474d-a011-f034025ca34d",
"app_settings": "//static.int.lvis.monterosa.co.uk/app_settings/project_124607/53a09406-701c-4c06-8a57-edfb6fb3b0ac/app_settings20140730-84374-1dbk8jj.json",
"audio_sync_default_delay": 0,
"audio_sync_max_delay": 0,
"tracking_id": "UA-XXXXX-X",
"embed": "//example.com/app.html?bc=l-f0c88d5d-6050-47c9-9573-3071a18fefd7&sh=d3vtzxnppyvur.cloudfront.net",
"is_localisation_supported": true,
"locales": [{
"key": "de",
"default": false,
"name": "Deutsch"
}, {
"key": "en",
"default": true,
"name": "English"
}]
},
"events": [
{
"id": "321449cd-467b-4bae-8186-1e1710ad6212",
"name": "Test event",
"start_at": 1407249942,
"start_at_iso": "2014-08-05T14:45:42Z",
"end_at": 1407250061,
"end_at_iso": "2014-08-05T14:47:41Z",
"started": true,
"image_url": null,
"custom_fields": {
"en" {
"field_key": "value"
}
},
"digest": "b2048ef76ef3dc9718e3b543900cd4d6baf7c31c"
}
],
"assets": {
"submissions": [
{
"name": "logo",
"data": "https://example.com/logo.png"
}
]
}
}