De GoedGeplaatst API

Voor wie is de API?

Voor bedrijven en softwareleveranciers die hun aanbod automatisch op Marktplaats willen zetten, zonder handwerk en zonder exportbestanden. Bijvoorbeeld als je je voorraad al in een eigen systeem beheert, of als je software bouwt voor meerdere winkels.

Heb je een webshop met een productfeed of WooCommerce? Dan heb je de API meestal niet nodig: gebruik dan de productimport of de WooCommerce-plugin.

Wat je met de API kunt

• Advertenties aanmaken, wijzigen, kopiëren en verwijderen, met foto's
• Plaatsen op Marktplaats en 2dehands, als reguliere advertentie
• Rubrieken en kenmerken ophalen, zodat je advertenties in de juiste rubriek komen
• Prijzen per rubriek opvragen voordat je plaatst
• Reacties van kopers ophalen en beantwoorden
• Statistieken van je advertenties en rapportages van transacties en betalingen
• Saldo en accountinstellingen beheren

Hoe het werkt

De API is een REST API die met JSON werkt. Elke aanroep stuur je met een vooraf gedeelde sleutel in de header Authentication. Daarnaast zetten we de IP-adressen van je servers op een whitelist. Zo kan alleen jouw systeem namens jouw account plaatsen.

GET /rest/v1/categories/ HTTP/2
Host: api.goedgeplaatst.nl
Content-Type: application/json; charset=utf-8
Authentication: <jouw API-sleutel>

In de documentatie van de REST API vind je alle endpoints, velden en een voorbeeldclient in PHP.

Zo begin je

1. Maak een gratis account aan.
2. Mail naar api-support@goedgeplaatst.nl met de IP-adressen van je servers. Je krijgt dan je API-sleutel.
3. Lees de documentatie en plaats je eerste advertentie.

Vragen over je koppeling? Ons team helpt je via api-support@goedgeplaatst.nl.