Entwickler
Die Schnittstelle von hfoods für Kassen, Warenwirtschaft und Partner.
Entwurf, noch nicht verfügbar
Die Schnittstelle wird gerade neu entworfen. Nichts auf diesen Seiten ist bereits in Betrieb, und bis zur Freigabe kann sich jedes Detail ändern. Baue noch keine Integration dagegen.
Was feststeht
Diese Grundregeln gelten für jeden Endpunkt, sobald die Schnittstelle freigegeben ist:
- Test und Live getrennt. Jeder Zugang hat einen Testschlüssel und einen Live-Schlüssel. Mit dem Testschlüssel entstehen nie echte Bestellungen, Zahlungen oder Drucke, alles andere verhält sich genau wie im Live-Betrieb.
- Einheitliche Fehler. Jeder Fehler kommt im gleichen Format, mit einem festen Fehlercode. Mehr unter Fehler.
- Sicher wiederholbar. Schreibende Aufrufe nehmen einen
Idempotency-Keyan. Eine Wiederholung nach einem Verbindungsabbruch führt nie zu einer doppelten Bestellung. - Beträge in Cent. 12,50 EUR sind
1250. Es gibt keine Kommazahlen. - Zeitpunkte in UTC nach RFC 3339, zum Beispiel
2026-09-26T14:30:00Z. - Verlässliche Versionen. Wie wir Änderungen ankündigen und wie lange alte Versionen laufen, steht unter Versionierung.
API-Referenz
Die vollständige Beschreibung aller Endpunkte steht in der API-Referenz. Sie wird direkt aus dem Vertrag erzeugt, gegen den auch unsere Server geprüft werden.