API und Konzepte

Die API-Referenz wird bei jedem Build aus packages/openapi/openapi.yaml generiert — derselben Datei, aus der auch der Go-Server und der TypeScript-Client entstehen. Sie kann deshalb nicht von der Wirklichkeit abweichen: was dort steht, ist das, was der Server implementiert.

Diese Seiten davor erklären die Konzepte, ohne die die Endpunkte nicht viel Sinn ergeben:

Seite	Frage
Authentifizierung	Welcher Schlüssel gehört wohin, und welcher darf in den Browser?
Preiskontexte	Warum hat ein Produkt mehr als einen Preis, und wie bekomme ich den richtigen?
Widget-Loader	Was passiert zwischen <script> und dem ersten Ergebnis?

Zwei Regeln, die für alles gelten

Typesense ist ein Implementierungsdetail. Die Suchmaschine wird nie direkt von einem Browser angesprochen, und ihre Schnittstelle ist kein Teil unseres Vertrags. Was wir zusagen, steht in der OpenAPI-Datei; alles andere darf sich ändern.

Einkaufspreise verlassen die API nicht. Die Marge steckt in der Sortierung, nicht in der Antwort. Es gibt keinen Parameter, mit dem sich ein Einkaufspreis abrufen ließe.

Basis-URL

https://api.antares.commergy.de

Für lokale Entwicklung gegen einen eigenen Stand steht die zweite Server-Adresse in der Referenz. Die Adresse deines Tenants zeigt dir das Panel unter Einstellungen → Integration.