Stripe API URL의/v1/for는 무엇입니까?

Question

Stripe API documentation for versioning 상태 : 우리는 API에 이전 버전과 호환되지 않는 변경하면

, 우리는 새로운 날짜가 기입 된 버전을 릴리스합니다. 현재 버전은 2014-12-08입니다.

그것은 특정 버전의 charge API에 액세스하는 방법의 예를 제공

: 헤더 매개 변수 (이 경우 2014년 12월 8일에) 버전을 지정하는 것입니다 경우

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

를, 무엇을 목적이 URL에 \v1\을 제공합니까?

Answer 1

엔지니어가 우리가 생각하기를 바라는 대답은 다음과 같습니다. 특정 시점에서 Stripe의 API에 큰 변화가있을 수 있으며 모든 것이 조정 된 방식이므로 이름을 바꾸는 등 큰 변화를 원합니다. v2. 이 방식으로 v1이 주요 버전이되고 2014-12-08과 같은 버전이 부 버전이됩니다. 따라서 v1은 의미 론적 버전 관리의 한 형태입니다.

그러나 실제로 일어난 일은 첫 번째 API를 발표하고 v1에서 호출 한 것입니다. 그런 다음 업데이트를 시작해야한다는 것을 알고 "v1을 v2로 변경하고 v3으로 변경하면 업데이트 할 때마다 사용자가 올바른 버전을 호출하도록 코드를 업데이트해야합니다. 동일한 URL을 사용하여 API 버전을 게이트 할 수있게 해주는 버전 헤더이며 URL의 v1은 단지 흔적을 남깁니다.