Hoe los je een 'API Key Invalid' fout op bij data-uploads?

Jan van Rijswijk

Meteoroloog & Weerstationdeskundige

Stel je voor: je hebt uren zitten sleutelen aan een perfecte datafeed voor je affiliate website.

Alles staat klaar, je klikt op 'Uploaden' en dan... BOOM. Een boodschap die je dag verpest: 'API Key Invalid'. Je voelt de frustratie al opborrelen. Geen paniek. Deze fout is supercommon, en eigenlijk best simpel op te lossen als je weet waar je moet kijken. Laten we hem samen fixen, alsof ik naast je zit.

Wat heb je nodig om dit op te lossen?

Voordat we beginnen, zorg dat je deze dingen bij de hand hebt. Het scheelt je zoeken en gedoe.

• Je inloggegevens voor het platform waar je de upload probeert te doen (bijvoorbeeld je affiliate netwerk dashboard zoals Awin, TradeDoubler of een tool zoals Zapier).
• Toegang tot je API-instellingen. Meestal vind je dit onder 'Profiel', 'Instellingen' of 'Ontwikkelaar'.
• Een teksteditor zoals Kladblok of Notepad++ om de key tijdelijk in te plakken.
• Ongeveer 10-15 minuten rustige tijd. Dit is geen klusje om tussendoor te doen.

Stap 1: Check de basis – typefouten en spaties

Dit klinkt kinderlijk eenvoudig, maar het is in 70% van de gevallen de oorzaak. Een API key is een lange, onleesbare reeks letters en cijfers.

1. Kopieer de key opnieuw vanuit de bron. Ga naar je API-instellingen, klik op 'Toon key' of 'Kopieer' en plak hem direct in je teksteditor.
2. Controleer op verborgen spaties. Soms kopieer je ongemerkt een spatie aan het begin of einde. Verwijder die handmatig.
3. Vergelijk de eerste en laatste 4 tekens. Komen die exact overeen met wat je had ingevoerd? Zo niet, weet je waar de fout zit.

Eén verkeerd teken en het is mis. Veelgemaakte fout: De key handmatig overschrijven. Nooit doen.

Altijd knippen en plakken. Een 'O' (letter) en een '0' (cijfer) zien er in sommige lettertypes hetzelfde uit.

Stap 2: Is je key verlopen of ingetrokken?

API keys zijn niet altijd eeuwig geldig. Platforms trekken ze in om veiligheidsredenen.

1. Zoek naar een vervaldatum. In het API-dashboard zie je vaak 'Gegenereerd op' en 'Verloopt op'. Is die datum verstreken? Dan moet je een nieuwe maken.
2. Check of je de key per ongeluk hebt verwijderd. Soms klik je in een opschoningsbui op 'Revoke' of 'Verwijderen'. Als de key niet meer in de lijst staat, is hij ongeldig.
3. Maak een nieuwe key aan. Klik op 'Genereer nieuwe key'. Let op: de oude key stopt dan direct met werken. Zorg dat je de nieuwe direct in je upload-tool invoert.

Tijdsindicatie: Een nieuwe key aanmaken en invoeren duurt 2 minuten. Testen of het werkt nog eens 30 seconden.

Stap 3: Zijn de permissies (rechten) goed ingesteld?

Dit is de meest onderschatte stap. Je key kan technisch geldig zijn, maar geen toestemming hebben voor wat jij wilt doen.

1. Ga naar de 'Scopes' of 'Permissies' van je key. Dit is een lijst met vinkjes zoals 'products:read', 'data:write' of 'feeds:upload'.
2. Vergelijk dit met wat je upload-tool nodig heeft. Wil je een productfeed uploaden? Dan moet er minimaal 'write'-toegang voor 'feeds' of 'products' aan staan. Alleen 'read' is niet genoeg.
3. Pas de permissies aan en sla op. Belangrijk: sommige platforms vereisen dat je de key daarna opnieuw genereert. Lees de kleine lettertjes.

Voorbeeld: Je gebruikt een tool als 'Make' (voorheen Integromat) om je WooCommerce data naar een affiliate netwerk te sturen. Net zoals je soms een 'Invalid Data' melding oplost, moet de key in Make 'write'-rechten hebben op het netwerk, anders blokkeert het netwerk de upload.

Stap 4: Test in een geïsoleerde omgeving

Nu we de key hebben gecontroleerd, is het tijd om te testen zonder je hele workflow te riskeren. Waarom dit helpt: Je sluit uit of het probleem bij de key zelf ligt, of bij je upload-tool (zoals Zapier). Als de test werkt, ligt de fout in de configuratie van je tool, vergelijkbaar met hoe je een 'Database Error' in WeatherLink oplost.

1. Gebruik een API-tester. Tools zoals Postman of de ingebouwde tester in het platform (vaak een 'Try it' knop) zijn perfect hiervoor.
2. Voer een simpele GET-request uit (bijvoorbeeld om je profiel op te halen). Werkt dat? Dan is je key geldig en heeft hij basale toegang.
3. Probeer nu een simpele POST-request (een test-upload met dummy-data). Faalt dit met 'Invalid'? Dan ligt het aan de permissies (zie stap 3).

Extra tips voor als het echt niet lukt

Soms zit het probleem dieper. Check dan nog dit:

• IP-whitelisting. Sommige platforms blokkeren keys die vanaf een onbekend IP-adres worden gebruikt. Voeg het IP-adres van je server of tool toe aan de whitelist.
• Rate limits. Heb je te veel uploads in korte tijd gedaan? Je key kan tijdelijk geblokkeerd zijn. Wacht 15-30 minuten en probeer opnieuw.
• Platform-storing. Check de statuspagina van het platform. Het kan een algemene API-storing zijn.

Verificatie-checklist: Is het nu opgelost?

Loop deze lijst na en kijk hoe je een script error op je weer-website oplost voordat je je grote upload start:

1. De key is gekopieerd, niet overgetypt, en bevat geen spaties.
2. De key is niet verlopen en staat als 'Actief' in het dashboard.
3. De key heeft de juiste 'write' of 'upload' permissies.
4. Een test in Postman of de platform-tester werkt.
5. Je upload-tool (Zapier, Make, eigen script) is bijgewerkt met de nieuwe key.

Klaar? Start die upload dan nog een keer. Je zult zien: het werkt nu wel. En mocht het ooit weer gebeuren, dan weet je precies waar je moet kijken.