Skip to main content
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
[tractusx-dev] Proposal: TRG for API Versioning
  • From: <tobias.zahn@xxxxxxxxxxxxxxxxx>
  • Date: Mon, 11 Dec 2023 15:51:11 +0000
  • Accept-language: de-DE, en-US
  • Arc-authentication-results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=mercedes-benz.com; dmarc=pass action=none header.from=mercedes-benz.com; dkim=pass header.d=mercedes-benz.com; arc=none
  • Arc-message-signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=n6BjuQiONmWBlJ+CKQKIqNeJYqzBJVdcl6TrVBjlpPg=; b=SEEVm99FgurhG/lcpk5SquGpvolZ+kNF4VSE5ynHcgSdvKDKVL68ZcvWcRLuVLJagqfKItwn2zzODyJN8c1WN4NR9mUS8Hpz0O8iqpDWD6fe+Sg3z1N6RzYxdEIn1gagctHXvHK/2DZaO48mCAY8LocVsuTpgW0yC163ClGDb4j7gmufJA7yADf92/gROnbui73raoGUXx37FG33iJsVjdIj25j6U3CJjyg2UMLP4w+6gOeWOEPbkpcqKWIMhGOjBcjSlUOyBRt/+AMUK6WZo7DwlTWuXoksji7R/LTCS9omL7bbE7xIE7jE0JOUGApZ2YiMll+2nKXuwGj0wkn12Q==
  • Arc-seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=MC4ckgcUSrNcNG1Nvhwe/UCGfe7IwP3kzrHrDWaJmuZlBx4VN5uZeEpFtNxDKMyK9cPm40VKyR0XNRq2wU9oZS7FYRHXsdvd6ltFuOaxLB1UzfpaUYK0X5fbtc1OfvELQ9Zl5CCmfhVeFkL00tkrrsK8cpy/ChmGAQdvzmdKvyc5CHokIlopgfUk5HhEHnmWFw4il+qF/eQ2TxX9W7Sx5VfgE3RhmXWulDiKeoRuEHfoKuJ2Y5u6py8E/TZax7KyLwoD9zktVG+EQXip26x3YxAFUV1QQyw4WcKi36HOX7W1i8GFPpkjsa3N1g4HeqfVQBo6YDFWG5PydXepdhAXEQ==
  • Delivered-to: tractusx-dev@xxxxxxxxxxx
  • List-archive: <https://www.eclipse.org/mailman/private/tractusx-dev/>
  • List-help: <mailto:tractusx-dev-request@eclipse.org?subject=help>
  • List-subscribe: <https://www.eclipse.org/mailman/listinfo/tractusx-dev>, <mailto:tractusx-dev-request@eclipse.org?subject=subscribe>
  • List-unsubscribe: <https://www.eclipse.org/mailman/options/tractusx-dev>, <mailto:tractusx-dev-request@eclipse.org?subject=unsubscribe>
  • Thread-index: AdosSdfjJmZ1gCIRSeSTVNzn9PaOmQ==
  • Thread-topic: Proposal: TRG for API Versioning

Hello developers,

many APIs in the world and also in Catena-X are versioned in order to ensure that changes on API-level are clearly identifiable. Also, versioning APIs enables backward compatibility, as one could choose to offer different versions of an API in parallel.

While there are rules in Catena-X for compatibility (see the whitepaper at https://catena-x.net/fileadmin/_online_media_/231006_Whitepaper_LifeCycleManagement.pdf), there is not yet a clear rule in Tractus-X how APIs should be versioned. However, there cannot be any compatibility without versioning.

Therefore, I would like to suggest adding an TRG regarding API versioning to Tractus-X. I have created a proposal as a pull request on GitHub at https://github.com/eclipse-tractusx/eclipse-tractusx.github.io/pull/526

 

Your feedback is highly appreciated.

Please feel free to give feedback on the TRG on GitHub or reach out to me via email.

 

 

Kind regards

Tobias F. Zahn

Mercedes-Benz AG
ITO/XA
HPC Werk 050 / HPC G 288

71059 Sindelfingen

Mobil: +49 176 30955133

email: tobias.zahn@xxxxxxxxxxxxxxxxx  

 

 

Mercedes-Benz AG, Stuttgart, Germany

Sitz und Registergericht/Domicile and Court of Registry: Stuttgart, HRB - Nr./Commercial Register No. : 762873

Vorsitzender des Aufsichtsrats/Chairman of the Supervisory Board: Bernd Pischetsrieder

Vorstand/Board of Management: Ola Källenius, Vorsitzender/Chairman; Jörg Burzer, Renata Jungo Brüngger, Sabine Kohleisen, Markus Schäfer, Britta Seeger, Hubertus Troska, Harald Wilhelm

 


If you are not the addressee, please inform us immediately that you have received this e-mail by mistake, and delete it. We thank you for your support.

Back to the top