Thực tiễn không tốt để đặt dấu chấm trong đường dẫn URI?

Question

Tôi đang thiết kế một API REST cho một ứng dụng web. Tôi muốn rõ ràng phiên bản API, để giao diện có thể được thay đổi trong tương lai mà không phá vỡ các dịch vụ hiện có. Vì vậy, trong API v1.0 của tôi, tôi muốn xác định rõ ràng nó là API v1.0, để tôi tự do phát hành phiên bản v1.1 trong tương lai với các thay đổi đột phá.

Câu hỏi của tôi là, một khoảng thời gian trong thành phần đường dẫn của URI có phải là thực tế không?

ví dụ: Có lý do chính đáng nào để không sử dụng http://example.com/myapi/v1.0/services làm URI cho dịch vụ của tôi không?

Answer 1

Đưa một khoảng thời gian trong URI là hoàn toàn tốt đẹp. Đặt một số phiên bản trong một URI chắc chắn không phải là một thực hành tốt nhất.

Here là lý do tại sao và here là bài viết hay về chủ đề của một người thông minh hơn tôi nhiều.

Answer 2

Tôi nghĩ đó là một ý tưởng hay. Tôi đã nhìn thấy một số dịch vụ nghỉ ngơi mà làm điều này.

Answer 3

Bạn hoàn toàn có thể chấp nhận sử dụng dấu chấm trong đường dẫn URI. Nó cũng hợp lệ theo RFC 3986 section 2.3.

Answer 4

của một nhân vật con đường hoàn toàn hợp lệ, xem trang 27 của spec http://www.ietf.org/rfc/rfc2396.txt

Không có lý do không sử dụng nó

Answer 5

Tôi nghĩ khác với những người khác ... Tôi không nghĩ đó là cách hay để sử dụng nó trên url.

IMHO nó tốt hơn nếu bạn phiên bản trên Tiêu đề loại nội dung.

Ví dụ: nếu bạn đang sử dụng ứng dụng/xml:

Loại nội dung: application/v1.0 + xml.

Sử dụng Loại nội dung, nó cũng chỉ ra rằng bản thân tài nguyên được phiên bản. Mặc dù nếu bạn sử dụng nó trên url, có vẻ như bạn đang phiên dịch dịch vụ (có vẻ như không phải vậy) và nếu bạn đang thay đổi dịch vụ, có thể bạn sẽ thay đổi url, vì vậy bạn không cần phiên bản con số.

EDIT: Bạn cũng nên sử dụng nó trên Accept Header, không chỉ trên Loại nội dung.