# Content Event

Provider API v0.6.7 · 2 operasjoner
Kilde: https://plasapi.com/no/provider/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å kall

**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()
```

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

### Parametere

- `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).

Felles for operasjonene: `ui_language`, `version`. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.7/)

### Svar

#### `200` Success

`GetContentEventsResponseBody`

Eksempel (Generert fra skjemaet):

```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`

Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.7/)

Eksempel (Generert fra skjemaet):

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

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

Ikke noe innhold i svaret.

Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/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å kall

**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()
```

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

### Parametere

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

Felles for operasjonene: `ui_language`, `version`. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.7/)

### Svar

#### `200` Success

`GetContentEventsInSeriesResponseBody`

Eksempel (Generert fra skjemaet):

```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`

Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.7/)

Eksempel (Generert fra skjemaet):

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

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

Ikke noe innhold i svaret.

Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.7/)

#### `404` Resource not found.

Ikke noe innhold i svaret.

Felles svar, definert én gang for hele API-et. [Se den felles kontrakten på versjonssiden.](https://plasapi.com/no/provider/v0.6.7/)