Ich entwerfe eine REST-API für eine Webanwendung. Ich möchte die API klar versionieren, so dass die Schnittstelle in der Zukunft geändert werden kann, ohne bestehende Dienste zu unterbrechen. Also in meiner v1.0 API, ich möchte es eindeutig als die v1.0 API identifizieren, was mir die Freiheit gibt, eine zukünftige v1.1 Version mit brechenden Änderungen freizugeben.
Meine Frage ist, wäre eine Periode in der Pfadkomponente eines URI schlecht?
z. Gibt es einen guten Grund, Ссылка nicht als URI für meinen Dienst zu verwenden?
Es ist ein perfekt gültiges Pfadzeichen, siehe Seite 27 der Spezifikation Ссылка
Kein Grund, es nicht zu benutzen
Es ist vollkommen akzeptabel, einen Punkt in einem URI-Pfad zu verwenden. Es gilt auch gemäß RFC 3986 Abschnitt 2.3 .
Ich denke anders als die anderen ... Ich denke nicht, dass es eine gute Übung ist, sie auf der URL zu verwenden.
IMHO ist es viel besser, wenn Sie auf dem Content-Type Header versionieren.
Als Beispiel, wenn Sie application / xml verwenden:
Inhaltstyp: application / v1.0 + xml.
Wenn Sie den Inhaltstyp verwenden, zeigt dies auch an, dass die Ressource selbst versioniert ist. Während, wenn Sie es auf der URL verwenden, scheint es, dass Sie den Dienst versionieren (was nicht so zu sein scheint), und wenn Sie den Dienst selbst ändern, werden Sie wahrscheinlich die URL ändern, so dass Sie die Version nicht benötigen Nummer.
BEARBEITEN: Sie sollten es auch für den Accept Header verwenden, nicht nur für den Inhaltstyp.
Ich denke, es ist eine gute Idee. Ich habe mehrere Erholungsdienste gesehen, die das tun.