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 Webflow-site waarvoor je een site-token kunt maken (Site settings > Apps & integrations > API access).
Verbinden
- Ga in APIboard naar Koppelen > Koppelingen.
- Zoek Webflow 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.
- Open je site in Webflow en ga naar Site settings > Apps & integrations > API access.
- Klik op Generate API token, noem het APIboard en zet alleen leesrechten aan voor Sites, Pages, CMS, Forms en Assets.
- Kopieer het token. Webflow laat het maar één keer zien; per site kun je maximaal 5 tokens hebben.
- Plak het token in het veld Site-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 Webflow, 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
APIboard koppelt één site per token. Heb je meer sites, koppel ze dan elk met een eigen token.
Welke gegevens je krijgt
| Onderwerp | Tabellen |
|---|---|
| Site en pagina’s | Site, Pagina’s |
| CMS | CMS-collecties, CMS-items |
| Formulieren | Formulieren, Formulier inzendingen |
| Media | Assets |
Je vraagt de gegevens op via de API en ziet ze in de Datawerkbank. Alle tabellen en velden staan in de API-documentatie van Webflow.
Hoe vaak vernieuwd
Pagina’s en CMS-items worden incrementeel opgehaald op basis van het laatste wijzigingsmoment. Formulieren, collecties en assets komen als complete lijst, met een veegpas voor verwijderde items. Voor formulierinzendingen biedt Webflow geen datumfilter, dus leest APIboard elke ronde het hele venster vanaf de grens van je pakket, met een overlapcontrole.
De eerste vulling van gegevens met een datum (zoals facturen, uren of mutaties) begint op 1 januari van het jaar dat bij je pakket hoort: Proefperiode en Basis dit kalenderjaar, Team ook vorig jaar, Pro ook twee jaar terug. Stamgegevens (zoals relaties of rekeningen) worden altijd volledig opgehaald. Wat al is opgehaald, verwijdert APIboard niet als je pakket kleiner wordt.
Hoe vaak dat gebeurt, hangt af van je pakket (Proefperiode, Basis, Team of Pro): zie Hoe vaak worden gegevens vernieuwd?.
Goed om te weten
- Wat wel wordt opgehaald: de ingevulde formulierinzendingen en de velddefinities van formulieren, de velden van CMS-items (RichText als platte tekst, maximaal 20.000 tekens) en het bestandsadres en de alt-tekst van assets.
- Wat niet wordt opgehaald: de mediabestanden zelf, bezoekersdata (Analyze) en e-commercegegevens.
- CMS-items krijgen de status Live, Live met concept, Concept, Gepland of Gearchiveerd.
- Bij het koppelen controleert APIboard de leesrechten voor Sites, Pages, CMS en Forms, maar niet voor Assets. Mist je token het recht voor Assets, dan lukt het koppelen wel, maar levert Assets niets op, zonder melding.
- Webflow geeft een limiet door in de antwoorden; APIboard pauzeert een minuut als er weinig over is en wacht bij een limiet. Mist het token leesrecht voor een onderdeel, dan slaat APIboard dat onderdeel 24 uur over.
- 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 nieuw site-token van dezelfde Webflow-site. 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
- Plak je Webflow-API-token. Het veld is leeg.
- Dit Webflow-token werkt niet. Controleer of je het hele token hebt gekopieerd en of het nog actief is. Plak het token opnieuw, of maak in Webflow een nieuw aan.
- Dit token hoort niet bij één site. Maak in de instellingen van je site een site-token aan. Je hebt een token voor een workspace of meerdere sites gebruikt. Maak een site-token aan in de instellingen van je site.
- Het token mist leesrecht voor Sites, Pages, CMS of Forms. Maak een nieuw token met leesrechten voor Sites, Pages, CMS, Forms en Assets. In de melding staat welk onderdeel ontbreekt. Maak een nieuw token met alle vijf de leesrechten.
- Webflow is even druk. Probeer het over een minuut opnieuw. Wacht een minuut en probeer het opnieuw.
- Deze Webflow-site is al gekoppeld. Deze site staat al in je organisatie.
- De pil Fout (401 of 403). Het token is ingetrokken of verlopen, of Webflow weigert de toegang tot de site. Gebruik Opnieuw verbinden met een nieuw token.
- 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.
Was dit artikel behulpzaam?