Versioniertes REST
Eine stabile /v1-API für Produkte, Hierarchien und Assets. Jeder Mandant hat eigene Tokens; jeder Token sieht nur seinen berechtigten Ausschnitt.
FUNKTION · API, FEEDS & AUSLIEFERUNGLIVE
Für jeden Consumer gebaut.
Shops, DXPs, Apps, Marktplätze und Feeds beziehen Produktdaten aus einer versionierten API — gefiltert auf das, was jeder Consumer sehen darf, ausgeliefert so, wie er es braucht, und reduziert auf das, was sich tatsächlich geändert hat.
REST /v1SIGNIERTE WEBHOOKSDELTA ~95 % KLEINER
01 · Was es tut
Eine API. Jedes Auslieferungsmuster. Nur die Änderungen.
Delta statt Dumps
Consumer fragen, was sich seit dem letzten Sync geändert hat, und erhalten genau das, auf Feldebene — rund 95 % kleiner als ein Vollexport.
Pull, Push oder geplant
Der Shop fragt ab, das CMS abonniert signierte Webhooks, oder Exporte werden nach Zeitplan geliefert. Muster pro Integration kombinierbar.
02 · REST-API
Ein stabiler, versionierter Vertrag für Ihre Integrationen.
Die PIM-Gate-API ist im Pfad versioniert. Integrationen gegen /v1 funktionieren weiter, während sich die Plattform entwickelt; inkompatible Änderungen erscheinen unter einer neuen Version, nie stillschweigend. Produkte kommen im kanonischen Schema mit ihren Attribut-Metadaten zurück, aufgelöst für den angefragten Markt und die angefragte Sprache, inklusive Fallbacks. Hierarchien und Assets sind eigenständige Ressourcen.
- REST-API /v1 für Produkte, Hierarchien und AssetsLIVE
- Parameter für Markt, Sprache und Katalogansicht bei jeder Produktabfrage
- Cursor-Paginierung für grosse Kataloge
- OpenAPI-Spezifikation und Doku-Portal docs.pimgate.ai2026
- GraphQL-Endpunkt für Consumer, die ihre Abfragen selbst gestalten2026
REST-API
Ein stabiler, versionierter Vertrag für Ihre Integrationen.
03 · Tokens & Berechtigungen
Jeder Token sieht seinen eigenen Katalog — serverseitig durchgesetzt.
API-Tokens werden pro Mandant ausgegeben und an einen Berechtigungsumfang gebunden: eine Katalogansicht, Märkte und Sprachen. Gefiltert wird serverseitig, bevor eine Antwort entsteht — ein Consumer kann sich also nicht in Daten hineinfragen, für die er nicht berechtigt ist, egal welche Abfrage er schickt. Rate Limiting schützt Plattform und Integrationen vor ausser Kontrolle geratenen Clients; das monatliche Abfragevolumen ist Teil Ihrer Version.
- Bearer-Tokens pro MandantLIVE
- Serverseitige Filterung nach Berechtigungen bei jeder AnfrageLIVE
- Rate Limiting pro TokenLIVE
- Inklusive API-Calls pro Monat: S 250k · M 2 Mio. · L 15 Mio. · XL 50 Mio.
- Jede Ausgabe, Rotation und Sperrung eines Tokens im Audit-Log protokolliert
Tokens & Berechtigungen
Jeder Token sieht seinen eigenen Katalog — serverseitig durchgesetzt.
04 · Delta-Sync
Fragen, was sich geändert hat. Nur das erhalten.
Jeder Export in PIM Gate ist versioniert, Änderungen werden auf Feldebene nachverfolgt. Ein Consumer ruft /v1/sync/diff?since= mit dem Zeitpunkt seines letzten erfolgreichen Syncs auf und erhält die neuen, geänderten und entfernten Produkte — bei Änderungen nur die Felder, die sich geändert haben. Die Payloads sind rund 95 % kleiner als Vollexporte, Syncs sind schneller abgeschlossen, und nachgelagerte Systeme verarbeiten keine unveränderten Datensätze mehr.
- Delta-Endpunkt /v1/sync/diff?since=LIVE
- Änderungen auf Feldebene statt ganzer DatensätzeLIVE
- Entfernungen umfassen auch Produkte, die den berechtigten Ausschnitt des Tokens verlassen haben
- Rund 95 % kleinere Payloads als Vollexporte
Delta-Sync
Fragen, was sich geändert hat. Nur das erhalten.
05 · Auslieferungsmuster
Der Shop fragt ab, das CMS abonniert, der Feed kommt pünktlich.
Jeder Consumer braucht Daten anders. Pull passt zu Shops und Apps, die bei Bedarf abrufen. Signierte Webhooks benachrichtigen ein DXP in dem Moment, in dem sich ein Produkt ändert — mit Verweis auf das Delta. Push liefert an Endpunkte, die Sie konfigurieren, und geplante Auslieferung erzeugt versionierte Exporte zu festen Zeiten für Partner, die mit Dateien arbeiten. Alle Muster schöpfen aus denselben validierten, berechtigten Daten.
- Pull über RESTLIVE
- Webhooks, signiert, damit der Empfänger Herkunft und Integrität prüfen kannLIVE
- Push an konfigurierte EndpunkteLIVE
- Geplante Auslieferung versionierter ExporteLIVE
- Exportformate XML · JSON · CSV · XLSXLIVE
- Änderungsbenachrichtigungen an Portal-Nutzer für ihren berechtigten Ausschnitt (E-Mail / Webhook)ROADMAP
Auslieferungsmuster
Der Shop fragt ab, das CMS abonniert, der Feed kommt pünktlich.
06 · Beispiele
Was Ihre Entwickler tatsächlich sehen.
Illustrative Anfragen an einen Demo-Mandanten mit fiktiven MESSARA-Daten. Feldnamen folgen dem kanonischen Schema; die vollständige Referenz erscheint mit der OpenAPI-Dokumentation.
GET /v1/products
GET /v1/products?market=CH&locale=de-CH&limit=2Host: messara.pimgate.aiAuthorization: Bearer pg_live_••••••••••••// Token-Umfang: view=installers-ch · market=CHHTTP/1.1 200 OK{ "data": [ { "sku": "MS-12011", "version": 42, "updated_at": "2026-09-24T02:04:11Z", "product_group": "druckmesstechnik", "name": { "de-CH": "Rohrfeder-Manometer D63, 0–10 bar, G 1/4 unten" }, "attributes": { "measuring_range_max": { "value": 10, "unit": "bar" }, "nominal_size": { "value": 63, "unit": "mm" }, "process_connection": { "value": "G 1/4 unten" }, "gtin": { "value": "4260000120114" } }, "price": { "list": 41.50, "currency": "CHF" }, "assets": [ { "id": "as_7c1e20", "type": "image", "href": "/v1/assets/as_7c1e20" }, { "id": "as_7c1e21", "type": "datasheet", "href": "/v1/assets/as_7c1e21" } ] } ], "meta": { "total": 287, "limit": 2, "next_cursor": "eyJza3UiOiJNUy0xMjAxNCJ9" }}GET /v1/sync/diff
GET /v1/sync/diff?since=2026-09-23T02:00:00ZHost: messara.pimgate.aiAuthorization: Bearer pg_live_••••••••••••HTTP/1.1 200 OK{ "since": "2026-09-23T02:00:00Z", "until": "2026-09-24T02:04:11Z", "from_version": 41, "to_version": 42, "changes": [ { "sku": "MS-12011", "op": "update", "fields": { "price.list": 41.50, "name.en-GB": "Bourdon tube pressure gauge D63, 0–10 bar, G 1/4 bottom" } }, { "sku": "MS-20415", "op": "create", "href": "/v1/products/MS-20415" }, { "sku": "MS-10433", "op": "remove" } ], "meta": { "count": 3, "next_cursor": null }}// Vollexport v42: 18,4 MB · dieses Delta: 0,9 MBWEBHOOK
POST /hooks/pimgate HTTP/1.1Host: shop.messara.exampleContent-Type: application/jsonX-PimGate-Event: product.updatedX-PimGate-Signature: t=1790215451,v1=3f9a…c21e// prüfen: HMAC über "t.body" mit Ihrem Webhook-Secret{ "event": "product.updated", "tenant": "messara", "occurred_at": "2026-09-24T02:04:11Z", "sku": "MS-12011", "version": 42, "changed_fields": ["price.list", "name.en-GB"], "delta": "/v1/sync/diff?since=2026-09-23T02:00:00Z"}ILLUSTRATIV · VERBINDLICH IST DIE API-REFERENZ
07 · Spezifikationen
API, Feeds & Auslieferung auf einen Blick.
| Spezifikation | Wert | Status |
|---|---|---|
| API-Stil | REST · JSON · VERSIONIERTER PFAD /v1 | LIVE |
| Authentifizierung | BEARER TOKEN · PRO MANDANT | LIVE |
| Autorisierung | SERVERSEITIGE FILTERUNG NACH BERECHTIGUNGEN | LIVE |
| Rate Limiting | PRO TOKEN | LIVE |
| API-Calls / Monat | S 250k · M 2 Mio. · L 15 Mio. · XL 50 Mio. | — |
| Auslieferungsmuster | PULL · PUSH · WEBHOOK (SIGNIERT) · GEPLANT | LIVE |
| Delta-Endpunkt | GET /v1/sync/diff?since= | LIVE |
| Delta-Granularität | FELDEBENE · ~95 % KLEINER | LIVE |
| Versionierte Exporte | JEDER EXPORT GESPEICHERT · VERGLEICHBAR | LIVE |
| Exportformate | XML · JSON · CSV · XLSX | LIVE |
| GraphQL | POST /graphql | 2026 |
| API-Dokumentation | OPENAPI · docs.pimgate.ai | 2026 |
| Änderungsbenachrichtigungen an Portal-Nutzer | E-MAIL · WEBHOOK | ROADMAP |
| Hosting / Datenresidenz | DE (HETZNER FALKENSTEIN) · CH AUF ANFRAGE | — |
08 · Typische Consumer
Alles, was HTTP und JSON spricht.
Ibexa DXPDrupalShopwareShopifyAdobe Commerce (Magento)Headless-Frontendsmobile AppsMarktplatz-KonnektorenGrosshandels-FeedsPrint-/PDF-StreckenKI-Agenten · über Open Data · 2026
Consumer integrieren über die REST-API oder gelieferte Exporte. Vorgefertigte Plugins sind damit nicht gemeint.
09 · FAQ
FAQ
- Ja. Die Integration wird einmal auf die PIM-Gate-API umgestellt; danach lassen sich Quellsysteme hinter dem Gate hinzufügen oder ersetzen, ohne die Shop-Seite zu ändern.
- Webhooks benachrichtigen; massgeblich ist der Delta-Endpunkt. Ein Consumer kann jederzeit /v1/sync/diff?since= mit dem Zeitpunkt seines letzten erfolgreichen Syncs aufrufen und vollständig aufholen.
- Ein GraphQL-Endpunkt ist für 2026 geplant. Die REST-API /v1 ist heute produktiv und bleibt unterstützt.