API-koppelingen: data ophalen en inlezen

Galleo biedt de mogelijkheid voor het benaderen van data via API-koppeling. De API is ingericht op basis van de open-source specificatie van OpenAPI, zie hiervoor onderstaande documentatie. Voorbeelden zijn onder meer het ophalen van openbare projectdata voor bedrijfswebsites en het koppelen van projectdata uit interne velden aan interne applicaties zoals Power BI en AFAS. Zodoende hoeven deze projectgegevens slechts op één plek te worden bijgewerkt. Gegevens uit Galleo zijn uitsluitend te benaderen indien er autorisatie tot de data is verleend via een API-key. Zie voor de beveiligingsmaatregelen tevens de pagina Informatiebeveiliging Galleo.

API-documentatie met testmogelijkheid: 
https://galleo-public-api.developer.azure-api.net/ 
Let op: Gebruik de juiste GET-functie om de API te testen (Public of PublicAndPrivate)

Data inlezen in Galleo

Voor het inlezen van gegevens in Galleo kan optioneel worden gekozen voor de importfunctie. Het importeren van gegevens verloopt via de knop rechtsboven in de projecteditor (zie onderstaande afbeelding). Importeren van data is mogelijk nadat een nieuw project is aangemaakt met een tijdelijke titel. 

Optioneel kan het importeren worden geautomatiseerd en uitgebreid naar bijvoorbeeld de expertiseprofielen. Om data te kunnen inlezen wordt een mappingtabel vastgesteld waarin wordt aangegeven welke data vanaf welk API-endpoint, eventueel met verschillende bronnen, in welke velden op Galleo moeten verschijnen. Ieder bedrijf beheert zijn eigen interne velden. 

Importeer-knop rechtsboven in de projecteditor

Data pushen naar Galleo

Voor het pushen van data naar Galleo wordt verwezen naar bovenstaande API-documentatie.

Data ophalen en websitekoppeling plugin

Het ophalen van data kan enerzijds verlopen door het opzetten van maatwerk code, zoals beschreven in de API-documentatie. Als alternatief is er voor het koppelen van openbare projecten aan Wordpress websites een plugin beschikbaar gesteld. Dit maakt het koppelen van bedrijfswebsites en eenduidig beheer van projecten in Galleo mogelijk. Hiermee kan deze koppeling relatief eenvoudig tot stand kan worden gebracht. Een bedrijf ontvangt een unieke key en kan vervolgens de projecten naar eigen behoefte in een bepaald design zoals de huisstijl op de bedrijfswebsite renderen. Keys voor websites zijn public-only en werken op de endpoints zoals benoemd in de documentatie (GET /external/project/public, GET /external/project/public/{idOrSlug})

De Wordpress plugin kan zodanig worden ingericht dat nieuwe projecten automatisch op de bedrijfswebsite verschijnen. Zonder plugin is het overigens ook mogelijk om handmatig een website te koppelen aan het Galleo API-endpoint, dat een gepagineerde opzet voor de projecten aanbiedt.

Websitekoppeling - Embedden afbeeldingen & Wordpress plugin

Koppeling aan bedrijfswebsites bieden het voordeel dat alle afbeeldingen kunnen worden "ingebed" op de bedrijfswebsite (embedden). Dit houdt in dat afbeeldingen vanuit Galleo kunnen worden getoond op uw bedrijfswebsite. De voorwaarde is dat op de bedrijfswebsite een melding wordt gemaakt over de mogelijke beeldrechten die van toepassing zijn én een link naar de bron van de afbeeldingen beschikbaar blijft, nadrukkelijk zonder dat de afbeeldingen fysiek op uw eigen server staan (geen fysieke kopie). Zodoende is het juridisch toegestaan om afbeeldingen tegelijkertijd op andere websites te tonen, feitelijk analoog aan de werking van bijvoorbeeld het zoeken op afbeeldingen in Google. Zie voor aanpak en vermelding bijvoorbeeld: Projects - WindBASE. Voor het opzetten van een websitekoppeling is tevens een Wordpress plugin beschikbaar.

API-sleutels verkrijgen

Ieder bedrijf met een licentie kan zijn API-sleutel zelf ophalen. Dit verloopt via de bedrijfsadmin die rechten heeft om de sleutels in te zien via de knop Koppelingen in het blauwe menu aan de linkerzijde.

Maatwerk oplossingen, interoperabiliteit en MCP-protocol

Iedere organisatie kent unieke vraagstukken, zoals het koppelen van bestaande projectendatabases en, AI-tools aan Galleo of de mogelijkheden van een MCP-protocol. De database van Galleo is volledig voorbereid op het faciliteren van organisaties en interoperabiliteit. Lees ook onze gids om meer inzicht te krijgen in de mogelijkheden.

Download de Galleo-gids "Data als fundament, AI als versneller"

(beschikbaar indien niet-ingelogd op Galleo)

Dit organisatievraagstuk gaat vaak verder dan Galleo. Op aanvraag maken we graag afspraken om onze developers op organisatieniveau te laten assisteren bij complexe digitale vraagstukken. Voor technische vragen kunnen overigens ook AI-tools zoals Copilot/ChatGPT/Gemini worden geraadpleegd. 

Licentie

API-endpoints zijn uitsluitend beschikbaar indien daarvoor een licentie is afgesloten, neem voor meer informatie en ook technische afstemming contact op via support@galleo.co.