Sicherstellen, Client-Updates auf neueste API-Version

Question

Ich lerne über die REST-Architektur-Stil, und es gibt einige Dinge, die ich nicht verstehe, wenn es um die Entwicklung eines Back-End-API für Clients kommt.

Ich habe über verschiedene Ansätze zur Versionierung einer http-API gelesen, die alle Sinn ergeben, aber wie geben Sie einem Client an, wenn er eine veraltete Version Ihrer API verwendet, dass er seine Version aktualisieren muss? Gibt es eine Möglichkeit, dies zu tun, ohne den Kunden persönlich zu kontaktieren und ihm mitzuteilen, dass er seine Version aktualisieren muss?

Ich dachte, es könnte eine Möglichkeit geben, dass der Client seine aktuelle Version angibt und eine entsprechende Nachricht gibt, wenn sie veraltet ist. Ist das Standard oder gar machbar?

Answer 1

In der Regel werden Clients unter zwei Umständen aktualisiert. Entweder möchten sie Funktionen, die in einer neueren Version verfügbar sind, oder Sie verzichten auf eine frühere Version.

Wenn Sie planen, die Unterstützung für eine API-Version zu verwerfen, sollten Sie dies unbedingt jedem Kunden mitteilen, den Sie proaktiv finden können. Wenn sie sich auf Ihre API-Version verlassen und ohne Warnung verschwinden, werden sie ehemalige Kunden sein.

In den meisten Fällen werden Clients Ihrer API den Netzwerkverkehr nicht nach einem Header oder einem anderen Indikator durchsuchen, der die API ändert. Sie zu bitten, dies zu tun, ist nicht standardisiert und mit ziemlicher Sicherheit nicht machbar.

Auch die Unterstützung für eine API-Version zu löschen, ist eine große Veränderung. Es verursacht Aufruhr in allen Ihren Kunden und zwingt sie, eine Codeänderung in ihren Anwendungen zu einem Datum Ihrer Wahl vorzunehmen. Es ist nicht leicht zu machen.