Die REST-API gibt Ihren eigenen Systemen dieselben Daten wie Ihre Mitarbeiter in TradeCatalog sehen: Produkte, Kundentarife, Kunden, Bestellungen, Preisanpassungen und das Aktivitätsprotokoll. Sie verwendet JSON über HTTPS und einen API-Schlüssel pro System.
Basis-URLLink zu diesem Abschnitt#
https://tradecatalog.app/api/v1
Jede Anfrage benötigt einen API-Schlüssel im Authorization-Header. Siehe Authentifizierung.
Wer kann es verwendenLink zu diesem Abschnitt#
- Besitzer und Administratoren erstellen und widerrufen Schlüssel. Andere Mitarbeiter und Käufer können das nicht.
- Der Arbeitsbereich benötigt eine Pro-Berechtigung oder ein Pilot-Konto, um Schlüssel zu erstellen.
- Demo-Arbeitsbereiche können die API nicht verwenden.
- Wenn Pro endet, kehrt der Arbeitsbereich zu Free zurück: vorhandene API-Schlüssel können weiterhin lesen, aber nicht schreiben. Katalogbearbeitungen und Käuferbestellungen in der App funktionieren weiter.
Ein Schlüssel gehört zu einem Arbeitsbereich. Er wirkt mit den Berechtigungen der Person, die ihn erstellt hat, sodass ein Schlüssel eines Besitzers oder Administrators alle Kundentarife sehen kann. Wenn diese Person den Arbeitsbereich verlässt, funktioniert der Schlüssel nicht mehr.
EndpunkteLink zu diesem Abschnitt#
| Methode | Pfad | Was es tut | Bereich |
|---|---|---|---|
| GET | /workspace | Der Arbeitsbereich, zu dem dieser Schlüssel gehört | lesen |
| GET | /products | Liste oder Suche nach Produkten, optional mit Kundentarifen | lesen |
| GET | /products/{id} | Ein Produkt mit seinem Preis | lesen |
| PUT | /products | Erstellen oder aktualisieren bis zu 100 Produkten anhand der SKU | schreiben |
| GET | /brands | Alle Marken | lesen |
| GET | /categories | Alle Kategorien | lesen |
| GET | /prices | Was ein Kunde für eine SKU zahlt und warum | lesen |
| GET | /customers | Handelskunden | lesen |
| GET | /customers/{id} | Die Bedingungen, Regeln, vereinbarten Tarife und Käufer eines Kunden | lesen |
| PUT | /customers | Erstellen oder aktualisieren bis zu 100 Kunden | schreiben |
| GET | /orders | Kürzlich erstellte Bestellungen, am neuesten zuerst | lesen |
| GET | /orders/{id} | Eine Bestellung mit Zeilen und Statusverlauf | lesen |
| PATCH | /orders/{id} | Eine Bestellung weitergeben | schreiben |
| GET | /price-changes | Preisanpassungen, am neuesten zuerst | lesen |
| GET | /price-changes/{id} | Vorschau einer Preisanpassung | lesen |
| GET | /activity | Wer hat was geändert | lesen |
Die vollständige maschinenlesbare Beschreibung finden Sie unter /api/v1/openapi.json.
Bevor Sie beginnenLink zu diesem Abschnitt#
- Lesen Sie Konventionen für Geldbeträge, Paging, Datumsangaben und wie
PUTfunktioniert. - Lesen Sie Fehler für Statuscodes und Wiederholungen.
- Halten Sie Schlüssel auf Ihrem Server. Die API erlaubt keine Browseranfragen (CORS).
Noch nicht in der APILink zu diesem Abschnitt#
- Webhooks: stattdessen
GET /orders?status=newabfragen. - Veröffentlichen, planen oder stornieren von Preisanpassungen: das in der App tun.
- Rabattregeln und vereinbarte Preise: diese mit
GET /customers/{id}abrufen, in der App ändern. - Löschen von Produkten oder Kunden, direktes Hochladen von Bildern, Einladen von Käufern, Bestellungen als Käufer platzieren.