Was ist das/v1/für URLs in Stripe API?

Question

Die Stripe API documentation for versioning Staaten:

Wenn wir rückwärts inkompatible Änderungen an der API machen, lassen wir neue datierte Versionen. Die aktuelle Version ist 2014-12-08.

Es ein Beispiel liefert, wie die charge API für eine bestimmte Version zuzugreifen:

curl https://api.stripe.com/v1/charges \ 
-u sk_test_BQokikJOvBiI2HlWgH4olfQ2: \ 
-H "Stripe-Version: 2014-12-08 

Wenn der Header-Parameter ist, was die Version (in diesem Fall 2014.12.08) gibt an, was Zweck dient die \v1\ in der URL dienen?

Answer 1

Die Antwort, die ein Ingenieur uns denken lassen möchte: Ich vermute an einem bestimmten Punkt, es könnte eine große Änderung an Stripe API und wie alles orchestriert wird, so dass sie eine so große Änderung wie Umbenennung machen v2. Auf diese Weise wäre v1 eine Hauptversion, und dann wären Versionen wie 2014-12-08 Nebenversionen. Daher ist v1 eine Form der semantischen Versionierung.

Was jedoch wirklich passiert ist, ist, dass sie die erste API freigegeben und v1 aufgerufen haben. Dann stellten sie fest, dass sie mit der Aktualisierung beginnen mussten und sagten: "Nun, wenn wir anfangen, v1 zu v2 und dann zu v3 zu ändern, müssen die Benutzer jedes Mal, wenn wir ein Update veröffentlichen, ihren Code aktualisieren, um die richtige Version aufzurufen Version Header, die sie die API-Versionen mit der gleichen URL Gate und die v1 in der URL ist nur noch rudimentär.