Skwirrel koppelen aan APIcenter

Je koppelt Skwirrel aan APIcenter met de toegangsgegevens voor de API van je Skwirrel-omgeving. Je doet dit één keer. Daarna gebruik je Skwirrel in al je integraties.

Wat je nodig hebt

• Een Skwirrel-omgeving. Het adres van een omgeving heeft de vorm [omgeving].skwirrel.eu.
• Toegangsgegevens voor de API van Skwirrel. Skwirrel ondersteunt twee soorten: een client ID met een client secret (OAuth2, grant type client_credentials) of een vaste token. Beide maak je aan in Skwirrel zelf.
• De rechten in Skwirrel om producten op te halen. Heeft de API-gebruiker die rechten niet, dan geeft Skwirrel de fout Method is forbidden.

APIcenter gebruikt versie 2 van de Skwirrel API. Skwirrel beschrijft deze API in de documentatie van Skwirrel.

Zo koppel je Skwirrel

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Skwirrel.
2. Vul een Weergavenaam in en vul de velden in die APIcenter voor Skwirrel toont met de toegangsgegevens uit Skwirrel.
3. Klik op Opslaan.
4. Klik op Testverbinding. APIcenter vraagt dan één product op bij Skwirrel. Zie je "Verbinding is goed!", dan is Skwirrel klaar voor gebruik.

De algemene stappen staan in Een nieuwe applicatie koppelen en Een applicatie bewerken.

Als het niet lukt

Skwirrel geeft bij een fout een HTTP-status en een vaste foutcode terug:

• Unauthorized (code -32001): de toegangsgegevens zijn niet geldig. Controleer ze in Skwirrel en vul ze opnieuw in.
• Method is forbidden (code -32002): de API-gebruiker mag deze actie in Skwirrel niet uitvoeren.
• URL not found (code -32003): het adres van de omgeving klopt niet. Controleer het adres.

Zie ook Verbinding of inloggen mislukt en Skwirrel: veelvoorkomende fouten.

Volgende stappen

Maak een integratie met Skwirrel en controleer de instellingen. Zie Skwirrel verbindings- en integratie-instellingen.