PIM · Aan de slag
Overzicht
Wat de PIM doet, wat de API levert en wat niet.
Wat de PIM doet
De PIM bewaart productinformatie op één plek. Leveranciers sturen hun producten, prijzen en voorraad naar de PIM. De PIM voegt dat samen tot één artikel per product, voor jouw bedrijf.
Via een API haal je die artikelen op. Je krijgt alleen de producten die voor jou bedoeld zijn.
Wat de API levert
De API heeft twee adressen om producten te lezen. Allebei geven JSON terug en allebei werken ze met pagina's.
| Endpoint | Wat je krijgt |
|---|---|
GET /products |
De producten die je mag verkopen, met de aanbiedingen van de leveranciers. |
GET /my-products |
Eén regel per klantartikel, met jouw prijs en voorraad, SEO, categorieën en kenmerken. |
Lees meer bij Producten en Mijn producten.
Het basisadres is https://pim.internetservicebureau.nl/api/v1. Je meldt je aan met een token. Dat token bepaalt van welk bedrijf de gegevens zijn, je geeft zelf geen klantnummer mee.
Wat de API niet doet
- Alleen lezen. Je kunt via de API niets aanpassen in de PIM.
- Geen meldingen. De PIM stuurt je niets als een product verandert. Je vraagt zelf op wat er sinds de vorige keer is gewijzigd. Hoe dat werkt, staat bij Synchroniseren.
- Geen bestellingen. Bestellingen plaatsen of ophalen kan niet via deze API.
- Geen token zelf aanmaken. Een token krijg je van de PIM-beheerder.
Wie regelt wat
De PIM-beheerder maakt je token aan en kan de toegang beperken tot vaste IP-adressen. Alles wat je daarna doet, doe je met je eigen code. Lees bij Verbinden hoe je begint.
Volgende stappen
- Vraag een token aan bij de PIM-beheerder en doe je eerste verzoek: Verbinden.
- Lees hoe een product bij jou terechtkomt: Hoe het werkt.
- Bekijk de velden en filters: Producten.
- Houd je gegevens up-to-date met een script: Synchroniseren.