APIs & Webhooks
Integrieren, ohne eine App zu schreiben
Ihr ERP-Integrator braucht Bestellungen heraus und Bestand hinein. Ihr BI-Team will einen nächtlichen Export. Die IT Ihres Kunden will einen Punchout-Endpunkt. Keiner von ihnen baut eine App, und keiner sollte das Developer Portal lesen müssen, um einen API-Schlüssel zu bekommen. Dieser Bereich ist die Kundenseite der Schnittstellen der Plattform: was existiert, wie Sie sicher Zugang geben, und wo die Grenze zur echten Entwicklung verläuft.
Verstehen
- Die Schnittstellen der Plattform auf einer Karte — REST API, Webhooks, Massenimport/-export, Punchout, SFTP — welche für welche Aufgabe.
- Schlüssel, Berechtigungen und Tenants — Wie Zugang funktioniert, und wie Sie einem Integrator genau genug geben.
- Die Sandbox — Ein Tenant, den Sie kaputt machen dürfen.
- Rate-Limits, Kontingente und Fair Use — Was bei 429 passiert, und wie Sie darum herum entwerfen.
Einrichten
- Einen API-Schlüssel anlegen — Einstellungen › Developer › API-Keys, mit Scope und Namen.
- Webhooks einrichten — Ihr System auf Ereignisse abonnieren.
- SFTP und Dateiaustausch — Für das ERP, das nur CSV spricht.
- Eine Sandbox einrichten — Bereitstellen, befüllen, dem Integrator übergeben.
Damit arbeiten
- Häufige API-Aufgaben nach Job — Bestellungen heraus, Bestand hinein, Preise hinein, Kunden hinein — die Rezepte.
- Massenexporte — Alles, nächtlich, für BI.
- Eine Integration durchgängig testen — Sandbox, Fixtures, die Checkliste.
Gesund halten
- Integrationen überwachen — Aufrufe, Fehler, Latenz, Webhook-Zustellung.
- Häufige API-Probleme — 401, 403, 429, 422 — und der Webhook, der nie ankommt.
- Mit API-Änderungen umgehen — Abkündigungen, Versionen, der Changelog.
Wo das anschließt
- Integrationsmuster — Batch, Echtzeit oder hybrid, bevor Sie eine Schnittstelle wählen.
- Das führende System festlegen — welches System welches Feld schreiben darf.
- Events und Webhooks — die Betreibersicht auf Abonnements und Wiederholungen.
- Punchout erklärt — die fünfte Schnittstelle, dort vollständig behandelt.
- Ihr ERP anbinden — das größere Projekt, in dem das sitzt.
- Manuelle Arbeit senken — wofür die Integration da ist.