Prepr Documentation

Prepr Documentation

Welcome to the Prepr Documentation. You'll find comprehensive guides and documentation to help you start working with Prepr as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Program guides

Prepr offers a feature to request the program guide created by the schedules.

To get the latest played tracks do a GET request on the /guides/{id} endpoint. The most common fields should include the following parameters:

exceptions = true, fields = show,users

{
    "2018-07-03": [
        {
            "from": "00:00:00",
            "until": "02:00:00",
            "offset": 0,
            "limit": 7200,
            "rules": {
                "id": "e165d807-bab2-48c8-a247-00db27397c72",
                "created_on": "2018-06-07T07:35:28+00:00",
                "changed_on": "2018-06-12T17:51:45+00:00",
                "label": "ShowSchedule",
                "offset": 0,
                "limit": 7200,
                "valid_from": "2018-06-04",
                "valid_until": null,
                "exception": false,
                "days": [
                    "2",
                    "3",
                    "4",
                    "5"
                ]
            },
            "show": {
                "id": "58f9f68f-c3f5-4dd0-9055-e95dbdf3d139",
                "created_on": "2018-06-12T17:27:36+00:00",
                "changed_on": "2018-06-26T08:17:02+00:00",
                "published_on": "2018-06-26T08:17:01+00:00",
                "unpublish_on": null,
                "label": "Show",
                "status": "published",
                "slug": null,
                "body": "",
                "name": "'t Wordt nu laat"
            },
            "users": {
                "586643d3-0c02-43fe-80bf-fba9590aa41b": [
                    {
                        "id": "97926b24-75c8-40d6-bf25-779d8ec77548",
                        "created_on": "2018-06-12T17:46:05+00:00",
                        "changed_on": "2018-06-12T17:51:39+00:00",
                        "last_seen": "2018-06-12T17:46:05+00:00",
                        "label": "Person",
                        "preposition": "",
                        "initials": "",
                        "firstname": "Evelien",
                        "prefix_lastname": "",
                        "lastname": "de Bruijn",
                        "nickname": null,
                        "tracking": true
                    },
                    {
                        "id": "d06fc0d7-ccd3-4467-bd0c-6bd97341fbbf",
                        "created_on": "2018-06-12T17:46:19+00:00",
                        "changed_on": null,
                        "last_seen": "2018-06-12T17:46:19+00:00",
                        "label": "Person",
                        "preposition": "",
                        "initials": "",
                        "firstname": "Carolien",
                        "prefix_lastname": "",
                        "lastname": "Borgers",
                        "nickname": null,
                        "tracking": true
                    }
                ]
            }
        }
    ]
}

With the exceptions parameter set to true you will receive the guide as it will be aired (With the exception rules included).

The show field returns the Show publication as scheduled.

The users field returns a list of the Person's scheduled grouped by the function of the person (Tag Id). In our example 586643d3-0c02-43fe-80bf-fba9590aa41b stands for the Tag DJ.

With the timelines field the result will contain the containers created on behalf of this rule for that day.

Filtering

With the param show.id it is possible to filter the guide for just one Publication :Show.

More about the guide can be found in the reference docs /guides/{id}.