Onderzoekdoen.nl koppelen | Helpcentrum

Wat je nodig hebt

De rol Admin of Member in je organisatie. Viewers hebben geen toegang tot Koppelen. Zie Wie mag koppelen?.
Tweestapsverificatie (2FA) op je APIboard-account.
Een vrije plek in je pakket: Proefperiode en Basis 3 koppelingen, Team 7, Pro 10 (plus eventueel een gekochte extra koppeling).
Een business-licentie van Onderzoekdoen.nl. Alleen daarmee kun je een API-key aanmaken.

Verbinden

Ga in APIboard naar Koppelen > Koppelingen.
Zoek Onderzoekdoen.nl bij Beschikbare koppelingen (of typ de naam in het zoekveld) en klik op de kaart. Er opent een venster dat je stap voor stap begeleidt.
Log in bij Onderzoekdoen.nl en ga naar instellingen, gebruikerbeheer.
Klik op “maak API-key aan” (dit kan alleen met een business-licentie).
Kopieer de API-key die je ontvangt en plak hem in het veld API-token in APIboard. Vul eventueel een Naam voor deze koppeling (optioneel) in.
Klik op Koppelen.
APIboard haalt direct de eerste gegevens op (Data wordt opgehaald…). Daarna zie je Verbonden met Onderzoekdoen.nl, met de dashboards die klaarstaan. Op Koppelen > Koppelingen staat de pil Bezig met ophalen… tot de eerste volledige ronde klaar is; daarna staat er Actief.

Account of administratie kiezen

Er is geen keuzescherm: één token hoort bij één Onderzoekdoen.nl-account. Heb je meer accounts, koppel ze dan elk met een eigen token. De koppeling gebruikt alleen de API van de Enquête tool.

Welke gegevens je krijgt

Onderwerp	Tabellen
Onderzoeken	Onderzoeken, Vragen
Deelnemers en antwoorden	Respondenten, Antwoorden

Je vraagt de gegevens op via de API en ziet ze in de Datawerkbank. Alle tabellen en velden staan in de API-documentatie van Onderzoekdoen.nl.

Hoe vaak vernieuwd

Elke ronde haalt APIboard de volledige lijst onderzoeken op. Per onderzoek leest APIboard eerst de respondenten en maakt daarvan een vingerafdruk (aantal respondenten, aantal afgerond, hoogste datum). Is die ongewijzigd, dan blijven vragen en antwoorden ongemoeid. Is hij gewijzigd, dan haalt APIboard de vragen en antwoorden van dat onderzoek opnieuw volledig op. Bij de bron verwijderde rijen worden herkend.

Onderzoekdoen.nl kent geen beperking per pakket: alle historie komt binnen, voor elk pakket.

Hoe vaak dat gebeurt, hangt af van je pakket (Proefperiode, Basis, Team of Pro): zie Hoe vaak worden gegevens vernieuwd?.

Goed om te weten

APIboard slaat alles op wat Onderzoekdoen.nl levert, ook open antwoorden, toelichtingen en kenmerken van respondenten.
APIboard houdt het aantal aanroepen laag en wacht bij een limiet van de bron.
Bekende vraagsoorten krijgen een Nederlands label (Open vraag, Tekstregel, Meerkeuze); andere soorten tonen de code van de bron.
Opnieuw verbinden vervangt alleen je inloggegevens. De koppeling, alle opgehaalde gegevens en de syncstand blijven staan, de status gaat terug naar Actief en de volgende synchronisatie haalt alleen wijzigingen op. Het verbindscherm opent direct, zonder bevestigingsvraag. Plak een nieuwe API-sleutel van hetzelfde Onderzoekdoen.nl-account. Log je in met een ander account, dan weigert APIboard dat met de melding “Dit is een ander account dan de koppeling die je opnieuw verbindt. Log in met hetzelfde account.” Dan is het een nieuwe koppeling.
Je vindt Opnieuw verbinden (pijlicoon) in het zijpaneel dat opent als je op de kaart van de koppeling klikt.
Een koppeling of account verwijderen (Koppeling verwijderen of het verwijderpictogram bij een account) wist ook alle opgehaalde gegevens. Dat kan niet ongedaan worden gemaakt.

Problemen oplossen

Vul je Onderzoekdoen.nl API-token in. Het veld is leeg. Plak het token en klik op Koppelen.
Token ongeldig of je licentie heeft geen API-toegang (business-licentie). Controleer of je de hele API-key hebt gekopieerd en of je een business-licentie hebt.
Onderzoekdoen.nl is even druk. Probeer het over een paar minuten opnieuw. Wacht even en klik opnieuw op Koppelen.
Onderzoekdoen.nl gaf een onverwacht antwoord. Probeer het later opnieuw. Probeer het later nog eens. Houdt het aan, neem dan contact op met support.
Dit Onderzoekdoen.nl-account is al gekoppeld. Dit token hoort bij een account dat al in je organisatie staat.
Viewers kunnen geen koppelingen beheren. Je hebt de rol Viewer. Vraag een Admin van je organisatie om je de rol Member te geven, of om de koppeling te maken.
Dit account is al gekoppeld. Wat je probeert te koppelen, staat al in je organisatie. Zoek het op onder Koppelen > Koppelingen.
Je hebt je koppelingen-limiet bereikt voor je pakket. (of Je hebt je accounts-limiet bereikt voor je pakket.) Kies Bekijk abonnementen om te upgraden, of koop een extra koppeling of extra account.
De pil Fout bij de koppeling. Een synchronisatie is mislukt of de toegang is verlopen of ingetrokken. APIboard probeert het bij een tijdelijke fout later zelf opnieuw; bij een verlopen toegang gebruik je Opnieuw verbinden.