# Content Event

Content API v0.6.7 · 2 operationer
Kilde: https://plasapi.com/da/content/v0.6.7/content-event/

Library events and series of events, such as author talks, reading clubs and activities for children. The vendor can fetch events with their time, place, pricing, admission and the works they relate to, and fetch the series an event belongs to.

## Get content events

`GET` `/content/event` · `GetContentEvents`

Retrieves a list of planned events with complete information. Returns full event representations suitable for detailed views.

Either `to_date` or `event_ids` must be included in a request.  
If `ui_language` is not set, all languages are return.


### Eksempel på kald

**cURL**

```bash
curl -X GET "$PLAS_BASE_URL/content/event?version=0.6.7" \
  -H 'Accept: application/json' \
  -H "Authorization: Bearer $PLAS_TOKEN"
```

**JavaScript**

```javascript
const response = await fetch(`${process.env.PLAS_BASE_URL}/content/event?version=0.6.7`, {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": `Bearer ${process.env.PLAS_TOKEN}`,
  },
});
const data = await response.json();
```

**Python**

```python
import os
import requests

response = requests.get(
    f"{os.environ['PLAS_BASE_URL']}/content/event",
    params={
        "version": "0.6.7",
    },
    headers={
        "Accept": "application/json",
        "Authorization": f"Bearer {os.environ['PLAS_TOKEN']}",
    },
)
data = response.json()
```

Værten og tokenet er miljøvariabler: `PLAS_BASE_URL` providerens adresse · `PLAS_TOKEN` et access token.

### Parametre

- `page` (i `query`, `integer`, valgfri) — Page number for pagination.
- `size` (i `query`, `integer`, valgfri) — Maximum number of events to return.
- `from_date` (i `query`, `string (date)`, valgfri) — Inclusive start date in YYYY-MM-DD format. If omitted, the server will use the current date in its local timezone (e.g., CET) as the default
- `to_date` (i `query`, `string (date)`, valgfri) — Inclusive end date.
- `event_ids` (i `query`, `array of string`, valgfri) — The event ids should be url encoded and separated by a comma (the comma should not be url encoded).

Fælles for operationerne: `ui_language`, `version`. [Se den fælles kontrakt på versionssiden.](https://plasapi.com/da/content/v0.6.7/)

### Svar

#### `200` Success

`GetContentEventsResponseBody`

Eksempel (Genereret ud fra skemaet):

```json
{
  "endOfResults": false,
  "events": [
    {
      "admission": {
        "type": "open"
      },
      "audiences": [
        {
          "id": "94549",
          "label": "Children"
        }
      ],
      "branch": {
        "branchId": "nordby-main",
        "branchName": "Nordby Main Library"
      },
      "categories": [
        {
          "id": "94549",
          "label": "Education"
        }
      ],
      "description": "An evening about how Norwegian crime fiction found readers all over the world.",
      "id": "94549",
      "images": [
        {
          "height": 1200,
          "mime": "png",
          "url": "https://images.nordby.bibliotek.example/covers/310552.jpg",
          "width": 800,
          "alt": {
            "text": "Your reservation is ready for pickup."
          },
          "caption": "Front cover",
          "credit": {
            "text": "Your reservation is ready for pickup."
          },
          "original": {
            "height": 1200,
            "mime": "png",
            "url": "https://images.nordby.bibliotek.example/covers/310552.jpg",
            "width": 800,
            "focalPoints": [
              {
                "type": "hotspot",
                "x": 0.5,
                "y": 0.5
              }
            ]
          },
          "type": "content"
        }
      ],
      "language": "nob",
      "location": {
        "location": "Auditorium, 2nd floor",
        "type": "at_branch"
      },
      "organizers": [
        {
          "id": "94549",
          "name": "Kari Nordmann"
        }
      ],
      "promoted": {
        "endTime": "2025-01-25T12:00:00+01:00",
        "startTime": "2025-01-25T11:00:00+01:00",
        "type": "promoted"
      },
      "relatedEvents": [
        "84411"
      ],
      "relevantWorks": {
        "type": "works",
        "workIds": [
          "882107"
        ]
      },
      "scheduling": {
        "endDate": "2025-01-25",
        "startDate": "2025-01-25",
        "type": "all_day"
      },
      "series": {
        "eventIds": [
          "84410"
        ],
        "seriesId": "3120"
      },
      "state": "scheduled",
      "teaser": "Join us for an evening about Norwegian crime fiction.",
      "title": "Author talk: Norwegian crime fiction",
      "updateTime": "2025-01-25T11:00:00+01:00",
      "url": "https://nordby.bibliotek.example/events/84410"
    }
  ],
  "total": 12
}
```

#### `400` The list of errors.

`Errors`

Fælles svar, defineret én gang for hele API’et. [Se den fælles kontrakt på versionssiden.](https://plasapi.com/da/content/v0.6.7/)

Eksempel (Genereret ud fra skemaet):

```json
{
  "errors": [
    {
      "code": 200103,
      "info": "200103: invalid/unsupported query parameter value"
    }
  ]
}
```

#### `401` Bearer token invalid, missing, or expired.

Intet indhold i svaret.

Fælles svar, defineret én gang for hele API’et. [Se den fælles kontrakt på versionssiden.](https://plasapi.com/da/content/v0.6.7/)

## Get content events in series

`GET` `/content/event/series/{seriesId}` · `GetContentEventsInSeries`

Retrieves a list of planned events in a given series. Returns full event representations suitable for detailed views.

If `ui_language` is not set, all languages are return.


### Eksempel på kald

**cURL**

```bash
curl -X GET "$PLAS_BASE_URL/content/event/series/3120?version=0.6.7" \
  -H 'Accept: application/json' \
  -H "Authorization: Bearer $PLAS_TOKEN"
```

**JavaScript**

```javascript
const response = await fetch(`${process.env.PLAS_BASE_URL}/content/event/series/3120?version=0.6.7`, {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": `Bearer ${process.env.PLAS_TOKEN}`,
  },
});
const data = await response.json();
```

**Python**

```python
import os
import requests

response = requests.get(
    f"{os.environ['PLAS_BASE_URL']}/content/event/series/3120",
    params={
        "version": "0.6.7",
    },
    headers={
        "Accept": "application/json",
        "Authorization": f"Bearer {os.environ['PLAS_TOKEN']}",
    },
)
data = response.json()
```

Værten og tokenet er miljøvariabler: `PLAS_BASE_URL` providerens adresse · `PLAS_TOKEN` et access token.

### Parametre

- `seriesId` (i `path`, `string`, påkrævet) — Event series id.
- `page` (i `query`, `integer`, valgfri) — Page number for pagination.
- `size` (i `query`, `integer`, valgfri) — Maximum number of events to return.

Fælles for operationerne: `ui_language`, `version`. [Se den fælles kontrakt på versionssiden.](https://plasapi.com/da/content/v0.6.7/)

### Svar

#### `200` Success

`GetContentEventsInSeriesResponseBody`

Eksempel (Genereret ud fra skemaet):

```json
{
  "events": [
    {
      "admission": {
        "type": "open"
      },
      "audiences": [
        {
          "id": "94549",
          "label": "Children"
        }
      ],
      "branch": {
        "branchId": "nordby-main",
        "branchName": "Nordby Main Library"
      },
      "categories": [
        {
          "id": "94549",
          "label": "Education"
        }
      ],
      "description": "An evening about how Norwegian crime fiction found readers all over the world.",
      "id": "94549",
      "images": [
        {
          "height": 1200,
          "mime": "png",
          "url": "https://images.nordby.bibliotek.example/covers/310552.jpg",
          "width": 800,
          "alt": {
            "text": "Your reservation is ready for pickup."
          },
          "caption": "Front cover",
          "credit": {
            "text": "Your reservation is ready for pickup."
          },
          "original": {
            "height": 1200,
            "mime": "png",
            "url": "https://images.nordby.bibliotek.example/covers/310552.jpg",
            "width": 800,
            "focalPoints": [
              {
                "type": "hotspot",
                "x": 0.5,
                "y": 0.5
              }
            ]
          },
          "type": "content"
        }
      ],
      "language": "nob",
      "location": {
        "location": "Auditorium, 2nd floor",
        "type": "at_branch"
      },
      "organizers": [
        {
          "id": "94549",
          "name": "Kari Nordmann"
        }
      ],
      "promoted": {
        "endTime": "2025-01-25T12:00:00+01:00",
        "startTime": "2025-01-25T11:00:00+01:00",
        "type": "promoted"
      },
      "relatedEvents": [
        "84411"
      ],
      "relevantWorks": {
        "type": "works",
        "workIds": [
          "882107"
        ]
      },
      "scheduling": {
        "endDate": "2025-01-25",
        "startDate": "2025-01-25",
        "type": "all_day"
      },
      "series": {
        "eventIds": [
          "84410"
        ],
        "seriesId": "3120"
      },
      "state": "scheduled",
      "teaser": "Join us for an evening about Norwegian crime fiction.",
      "title": "Author talk: Norwegian crime fiction",
      "updateTime": "2025-01-25T11:00:00+01:00",
      "url": "https://nordby.bibliotek.example/events/84410"
    }
  ],
  "total": 12
}
```

#### `400` The list of errors.

`Errors`

Fælles svar, defineret én gang for hele API’et. [Se den fælles kontrakt på versionssiden.](https://plasapi.com/da/content/v0.6.7/)

Eksempel (Genereret ud fra skemaet):

```json
{
  "errors": [
    {
      "code": 200103,
      "info": "200103: invalid/unsupported query parameter value"
    }
  ]
}
```

#### `401` Bearer token invalid, missing, or expired.

Intet indhold i svaret.

Fælles svar, defineret én gang for hele API’et. [Se den fælles kontrakt på versionssiden.](https://plasapi.com/da/content/v0.6.7/)

#### `404` Resource not found.

Intet indhold i svaret.

Fælles svar, defineret én gang for hele API’et. [Se den fælles kontrakt på versionssiden.](https://plasapi.com/da/content/v0.6.7/)