JSON of XML feeds

Voor integraties, apps en maatwerkfunctionaliteit is het waardevol om content niet alleen te kunnen lezen, maar ook om de structuur, relaties en extra velden mee te krijgen. Daarvoor is er de feed API. Dit endpoint is bedoeld als een praktische bouwsteen voor ontwikkelaars die op een betrouwbare manier content uit een categorieën van de website willen ophalen en daar verder op willen bouwen, in een formaat dat makkelijk te verwerken is in eigen software.

De endpoint levert gestructureerde data in JSON of XML. In plaats van alleen titels en samenvattingen ontvang je een compleet pakket aan informatie over de categorie zelf, de onderliggende subcollecties en de individuele items. Denk aan duidelijke identifiers, aanmaak- en wijzigingsdatums, zowel tekst- als HTML-versies van titels en content, en waar beschikbaar ook de links naar de openbare pagina’s. Daarmee is de output geschikt voor uiteenlopende toepassingen, zoals het voeden van een mobiele app, een portal, een intranet, een koppeling met een extern platform of het opbouwen van een eigen zoek- of archieffunctie.

Voor websitebeheerders zit de waarde vooral in de flexibiliteit. Je hoeft content niet opnieuw in te voeren of te exporteren naar allerlei losse systemen, omdat de website zelf de bron blijft. Tegelijk krijgen ontwikkelteams precies genoeg context om de content op een nette manier te hergebruiken, zonder afhankelijk te zijn van schermscraping of fragiele maatwerkoplossingen. Dit maakt uitbreidingen toekomstbestendiger en vermindert het risico dat integraties stukgaan bij aanpassingen in de vormgeving van de website.

Een belangrijk voordeel is dat de feed rekening houdt met de publicatiestatus en de instellingen van de categorie. Links naar publieke pagina’s worden alleen meegegeven wanneer het tonen van collectie- en itempagina’s is ingeschakeld en wanneer de content daadwerkelijk gepubliceerd is. Daardoor is het eenvoudiger om externe toepassingen dezelfde zichtbaarheid te laten respecteren als de website zelf. Je voorkomt hiermee dat concepten of verborgen onderdelen per ongeluk in externe systemen belanden.

Daarnaast bevat de feed ondersteuning voor de extra velden van items. Deze velden worden in een uniform formaat teruggegeven, inclusief type, naam en waarde. Voor specifieke veldtypen, zoals locatiegegevens, wordt de waarde netjes uitgesplitst in bruikbare onderdelen zoals straat, huisnummer, postcode en coördinaten. Dat is bijzonder handig wanneer je content wilt verrijken met kaarten, routefunctionaliteit, filters of locatiegebaseerde weergaves, zonder dat je hiervoor extra bewerkingen hoeft te doen in de afnemende applicatie.

Ook voor grotere categorieën blijft de feed praktisch inzetbaar doordat paginering standaard is ingebouwd. Je kunt dus pagina voor pagina synchroniseren, terwijl de response ook direct aangeeft wat de volgende en vorige pagina is. Hierdoor is het geschikt voor zowel realtime gebruik als voor periodieke synchronisatie, bijvoorbeeld wanneer een externe applicatie dagelijks of elk uur nieuwe content wil ophalen.

Toegang tot de feed is bewust afgeschermd. Het endpoint werkt met autorisatie via een API-sleutel, zodat je zelf controle houdt over welke partijen toegang krijgen tot de data. Dit is vooral relevant wanneer de feed gebruikt wordt voor interne koppelingen of wanneer je content in een gecontroleerde omgeving wilt hergebruiken. Zo combineer je het gemak van een eenvoudige uitlees-API met de zekerheid dat niet iedereen zomaar alle data kan ophalen.

Later in het traject kan het handig zijn om te kiezen welk type feed het beste past bij de situatie. Waar standaardfeeds vooral ideaal zijn voor brede compatibiliteit met feedlezers en aggregators, is deze feed juist gemaakt voor rijke integraties en maatwerk. Daarmee is het een krachtige aanvulling voor organisaties die hun website niet alleen als publicatiekanaal zien, maar ook als centrale contentbron voor andere digitale diensten.