API Documentatie

De DAMS Collection API biedt programmatische toegang tot Open Vlacc. Deze RESTful API stelt ontwikkelaars in staat om entiteiten te beheren, te zoeken en te integreren met externe systemen.

Overzicht

Eigenschap	Waarde
Base URL	https://cultuur-connect-vlacc-uat.cloud.inuits.dev/collection/v1
Versie	1.0.0
Authenticatie	Bearer Token (OAuth 2.0)
Formaten	JSON, JSON-LD, CSV, RDF, Turtle, N-Triples

Endpoints

De API biedt de volgende endpoints:

Config

Methode	Endpoint	Beschrijving
GET	/config	Haal configuratie op

Entities

Methode	Endpoint	Beschrijving
GET	/entities	Lijst van entiteiten ophalen
POST	/entities	Nieuwe entiteit aanmaken
POST	/entities/filter	Entiteiten filteren
GET	/entities/{id}	Specifieke entiteit ophalen
PUT	/entities/{id}	Entiteit volledig bijwerken
PATCH	/entities/{id}	Entiteit gedeeltelijk bijwerken
DELETE	/entities/{id}	Entiteit verwijderen
GET	/entities/wem/{manifestation_id}	WEM data voor manifestatie

Authenticatie

De API gebruikt Bearer Token authenticatie. Voeg je token toe aan elke request:

curl -X GET \
  "https://cultuur-connect-vlacc-uat.cloud.inuits.dev/collection/v1/entities" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

→ Meer over authenticatie

Response formaten

De API ondersteunt meerdere output formaten via de Accept header:

Accept Header	Formaat
application/json	JSON (standaard)
application/ld+json	JSON-LD (Linked Data)
text/csv	CSV
application/rdf+xml	RDF/XML
text/turtle	Turtle
application/n-triples	N-Triples

Voorbeeld: JSON-LD response

curl -X GET \
  "https://cultuur-connect-vlacc-uat.cloud.inuits.dev/collection/v1/entities" \
  -H "Accept: application/ld+json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Paginering

Gebruik limit en skip voor paginering:

# Eerste 20 resultaten
/entities?limit=20&skip=0

# Volgende 20 resultaten
/entities?limit=20&skip=20

Filteren

Filter op entity type:

/entities?type=work
/entities?type=expression
/entities?type=manifestation
/entities?type=item

Code voorbeelden

Python

import requests

BASE_URL = "https://cultuur-connect-vlacc-uat.cloud.inuits.dev/collection/v1"
TOKEN = "your_access_token"

headers = {
    "Authorization": f"Bearer {TOKEN}",
    "Accept": "application/json"
}

# Haal alle werken op
response = requests.get(
    f"{BASE_URL}/entities",
    headers=headers,
    params={"type": "work", "limit": 10}
)

entities = response.json()
for entity in entities:
    print(entity["title"])

JavaScript

const BASE_URL = 'https://cultuur-connect-vlacc-uat.cloud.inuits.dev/collection/v1';
const TOKEN = 'your_access_token';

async function getEntities(type = 'work', limit = 10) {
  const response = await fetch(
    `${BASE_URL}/entities?type=${type}&limit=${limit}`,
    {
      headers: {
        'Authorization': `Bearer ${TOKEN}`,
        'Accept': 'application/json'
      }
    }
  );
  return response.json();
}

// Gebruik
const works = await getEntities('work', 10);
console.log(works);

Interactive API Reference

Bekijk de volledige interactieve API documentatie:

Interactieve documentatie

Ga naar de API Reference voor de volledige interactieve API documentatie met Scalar.

Support

• 📧 Developers: developers@inuits.eu
• 📖 Source: GitLab Repository