De REST API geeft uw eigen systemen dezelfde gegevens als uw medewerkers zien in TradeCatalog: producten, klantprijzen, klanten, bestellingen, prijsveranderingen en de activiteitenlog. Het gebruikt JSON over HTTPS en één API-sleutel per systeem.
Basis-URLLink naar deze sectie#
https://tradecatalog.app/api/v1
Elke aanvraag vereist een API-sleutel in de Authorization header. Zie Authenticatie.
Wie kan het gebruikenLink naar deze sectie#
- Eigenaren en beheerders maken en intrekken sleutels. Andere medewerkers en kopers kunnen dit niet.
- De werkruimte moet een Pro-entiteit of een pilot-account hebben om sleutels te maken.
- Demo-werkruimtes kunnen de API helemaal niet gebruiken.
- Wanneer Pro eindigt, keert de werkruimte terug naar Free: bestaande API-sleutels kunnen nog steeds lezen, maar niet schrijven. Cataloguswijzigingen en koperbestellingen in de app blijven werken.
Een sleutel behoort tot één werkruimte. Het werkt met de rechten van de persoon die het heeft gemaakt, dus een eigenaar’s of beheerder’s sleutel kan elke klantprijzen zien. Als die persoon de werkruimte verlaat, stopt de sleutel met werken.
EindpuntenLink naar deze sectie#
| Methode | Pad | Wat het doet | Toegang |
|---|---|---|---|
| GET | /workspace | De werkruimte waar deze sleutel toe behoort | lezen |
| GET | /products | Producten lijsten of zoeken, optioneel met klantprijzen | lezen |
| GET | /products/{id} | Een product met zijn prijs | lezen |
| PUT | /products | Creëer of update maximaal 100 producten per SKU | schrijven |
| GET | /brands | Alle merken | lezen |
| GET | /categories | Alle categorieën | lezen |
| GET | /prices | Wat een klant betaalt voor een SKU, en waarom | lezen |
| GET | /customers | Handelsklanten | lezen |
| GET | /customers/{id} | De voorwaarden, regels, overeengekomen prijzen en kopers van een klant | lezen |
| PUT | /customers | Creëer of update maximaal 100 klanten | schrijven |
| GET | /orders | Recente bestellingen, nieuwste eerst | lezen |
| GET | /orders/{id} | Een bestelling met lijnen en statusgeschiedenis | lezen |
| PATCH | /orders/{id} | Een bestelling verderzetten | schrijven |
| GET | /price-changes | Prijsveranderingen, nieuwste eerst | lezen |
| GET | /price-changes/{id} | Een prijsverandering bekijken | lezen |
| GET | /activity | Wie wat heeft gewijzigd | lezen |
De volledige machine-leesbare beschrijving is te vinden op /api/v1/openapi.json.
Voordat u begint met bouwenLink naar deze sectie#
- Lees Conventies voor geld, paginering, datums en hoe
PUTwerkt. - Lees Fouten voor statuscodes en herproeven.
- Houd sleutels op uw server. De API stelt geen browser (CORS) aanvragen toe.
Nog niet in de APILink naar deze sectie#
- Webhooks: gebruik in plaats daarvan
GET /orders?status=new. - Publiceren, plannen of annuleren van prijsveranderingen: doe dit in de app.
- Kortingsregels en overeengekomen prijzen: lees ze met
GET /customers/{id}, wijzig ze in de app. - Verwijderen van producten of klanten, direct uploaden van afbeeldingen, kopers uitnodigen, bestellingen plaatsen als koper.