Zum Inhalt springen
Developer

Erste Schritte

Alles, was ihr für den ersten Aufruf der REST-API von vynst (inwendo ERP) braucht: Anmeldung, Format, Listen und Fehler.

  1. AuthentifizierungMit Session-Token oder API-Zugang (JWT) an der REST-API von vynst (inwendo ERP) anmelden.
  2. Anfragen und AntwortenFormat von Anfragen und Antworten der REST-API von vynst (inwendo ERP), Header und Hüllen-Objekte.
  3. Listen, Seiten und FilterListen der REST-API von vynst (inwendo ERP) seitenweise laden, durchsuchen und sortieren.
  4. FehlerFehlercodes der REST-API von vynst (inwendo ERP) verstehen und behandeln.
  5. Codebeispiele und Dart-PackageWoher die Codebeispiele kommen und wie das Dart-Package iw_erp_api genutzt wird.

Lizenz und Kompatibilität

Lizenz und Haftungsausschluss:

Nutzer dürfen unsere öffentlichen REST-APIs verwenden und ändern, um ihre Nutzung der inwendo ERP im Rahmen der Rechte zu ermöglichen, die sie separat von inwendo erworben haben, während der Laufzeit ihrer Lizenz oder ihres Abonnements.

Wir geben keine Garantien, Zusicherungen oder sonstigen Gewährleistungen in Bezug auf unsere öffentlichen REST-APIs oder deren Verbesserungen. Außerdem bieten wir keinen besonderen Support für unsere öffentlichen REST-APIs, sofern wir dies nicht schriftlich anders vereinbart haben.

Abwärtskompatibilität und Einschränkungen:

Entwickler und Unternehmen sollten nicht überrascht werden, dass ein wichtiger Endpunkt nicht mehr erreichbar ist, sich unerwartet verhält oder sich so verändert, dass ein etablierter Ablauf gestört wird. Wir ergreifen Maßnahmen, um die Abwärtskompatibilität unserer APIs sicherzustellen.

Wir betrachten die folgenden Änderungen als abwärtskompatibel:

Additive Änderungen:

• Hinzufügen einer neuen Ressource (d. h. einer neuen URL bzw. eines neuen Pfads in den APIs)

• Hinzufügen neuer optionaler Anfrageparameter

• Hinzufügen neuer JSON-Felder in API-Antworten

• Ändern der Länge oder des Formats von Zeichenketten in Fehlermeldungen

Grenzen und Einschränkungen:

• Der API-Client sollte alle oben genannten additiven Änderungen korrekt verarbeiten.

• inwendo kann sinnvolle Gleichzeitigkeits- und Ratenbegrenzungen anwenden, wenn die Integrität der inwendo ERP und/oder die Dienstqualität gefährdet ist, auch wenn eine einzelne Ressource derzeit keine Ratenbegrenzung hat.

Versionen und Außerbetriebnahme:

• Wenn grundlegende Änderungen nötig sind, um die inwendo ERP weiterzuentwickeln, stellen wir Versionsaktualisierungen für einzelne APIs bereit, die durch Erhöhung der nächsten ganzen Zahl gekennzeichnet werden – zum Beispiel /v1/metrics, /v2/metrics usw.