Technisches Konzept Versionierung


images/download/attachments/268154482/ApiVersionierung-version-1-modificationdate-1612877344141-api-v2.png


  • Dokumentierung muss Versioniert werden

  • Partner muss eine bestimmte Anzahl an Versionen unterstützen (CloudApi policy)

  • Es gibt einen Contract der festlegt welche Version genutzt wird (Lizenz)

  • Der Scope einer Version umfasst alle ihr zugeordneten RequestTypes

  • ERP-Seite muss pro Version des Partner mit unterschiedlichen BDEs arbeiten können

  • JSON.NET ermöglicht Deserialisierung in Klassen auch wenn undefinierte Felder in der JSON enthalten sind (werden geschluckt) → Der Json.Net serializer hat eine "MissingMemberHandling" Einstellung die geändert werden kann. Standardmäßig ist dies auf "Ignore" gesetzt und sollte auch bei uns nicht geändert werden damit nicht vorhandene Felder weiterhin ignoriert werden und kein Fehler geschmissen wird.

  • ERP und Partner müssen immer über die gleiche Version kommunizieren

  • ERP muss je nach angeschlossenem Partner mehrere Versionen unterstützen

Version Uplifting

images/download/attachments/268154482/Unbenanntes_Diagramm-version-4-modificationdate-1612877584884-api-v2.png