REST - Trao đổi giữa đàm phán nội dung thông qua tiêu đề Chấp nhận so với tiện ích mở rộng

Tôi đang làm việc thông qua việc thiết kế API RESTful. Chúng tôi biết rằng chúng tôi muốn trả về JSON và XML cho bất kỳ tài nguyên nào. Tôi đã nghĩ rằng chúng tôi sẽ làm một cái gì đó như thế này:

GET /api/something?param1=value1
Accept:  application/xml (or application/json)

Tuy nhiên, ai đó đã sử dụng tiện ích mở rộng cho việc này, như vậy:

GET /api/something.xml?parm1=value1 (or /api/something.json?param1=value1)

Sự đánh đổi với những cách tiếp cận này là gì? Có phải tốt nhất là dựa vào tiêu đề chấp nhận khi tiện ích mở rộng không được chỉ định, nhưng tôn trọng tiện ích mở rộng khi được chỉ định? Có một nhược điểm cho cách tiếp cận đó?

Điều này, "Tuy nhiên, về mặt triết học - cách tiếp cận đầu tiên là cách tiếp cận duy nhất." Và đây là "Cách tiếp cận RESTful chính thức phù hợp là sử dụng tiêu đề Accept:". được nhận thức rộng rãi là trường hợp, nhưng cũng hoàn toàn không chính xác .

Đây là một đoạn ngắn từ Roy Fielding (người định nghĩa REST) ​​...

"phần 6.2.1 không nói rằng nên sử dụng đàm phán nội dung mọi lúc." trích dẫn

Cuộc hội thoại cụ thể đó nằm trong ngữ cảnh của tiêu đề 'Ngôn ngữ chấp nhận:', nhưng cũng áp dụng tương tự cho tiêu đề 'Chấp nhận:', như được làm rõ sau này trong phản hồi của anh ấy ...

"Tôi không biết tại sao mọi người không thể thấy liên kết thứ hai và thứ ba trên trang đầu

http://www.ics.uci.edu/~fielding/pub/dissertation/top.htm

chỉ ra hai phiên bản PDF. "

Điều ông muốn nói là không có vấn đề gì trong việc sử dụng các điểm cuối khác nhau cho các biểu diễn khác nhau của cùng một dữ liệu nguồn. (Trong trường hợp này, một điểm cuối .html và hai điểm cuối .pdf khác nhau.)

Cũng trong một cuộc thảo luận tương tự, lần này liên quan đến ưu điểm của việc sử dụng tham số truy vấn so với sử dụng tiện ích mở rộng tệp cho các loại phương tiện khác nhau ...

"Đó là lý do tại sao tôi luôn thích các tiện ích mở rộng. Cả hai lựa chọn đều không liên quan gì đến REST." trích dẫn

Một lần nữa, điều đó hơi khác so với Chấp nhận so với các phần mở rộng tên tệp, nhưng lập trường của Fielding vẫn rõ ràng.

Trả lời - nó thực sự không quan trọng lắm. Sự đánh đổi giữa hai người không quá quan trọng và cả hai đều là phong cách chấp nhận được.

Cách tiếp cận RESTful chính thức thích hợp là sử dụng Accept:tiêu đề.

Tuy nhiên, bạn phải cẩn thận để không phá vỡ tính lưu trữ, đây là một trong những yêu cầu của REST. Bạn cần phải có Vary: Accepttiêu đề và bộ nhớ cache để hiểu nó. Trong thế giới lý tưởng bạn sẽ có nó, nhưng trong cuộc sống thực, phần kê của bạn có thể thay đổi. Vì vậy, giải pháp thứ hai không sạch sẽ, nhưng nó có thể thực tế hơn.

Ngoài ra, lưu ý rằng một số trình duyệt rất cũ được sử dụng để bỏ qua các tiêu đề, thay vào đó dựa vào tiện ích mở rộng.

Về mặt kỹ thuật, điều đó không thực sự quan trọng - máy chủ web của bạn sẽ có thể vượt qua quá trình một cách thích hợp như mong muốn. (Tôi đang giả sử điều này nhưng không giống như một showstopper).

Tuy nhiên, về mặt triết học - cách tiếp cận đầu tiên là cách tiếp cận duy nhất. Trong REST, URL thực sự chỉ trỏ đến một URI - vốn chỉ là một tài nguyên. Hãy suy nghĩ một lúc tài nguyên này giống như đối tượng trong lập trình hướng đối tượng. Bạn nói chuyện với tài nguyên này chỉ thông qua 4 phương thức (còn gọi là GET / POST / PUT / DELETE -hoặc nếu bất cứ điều gì vận chuyển cho phép) nhưng phương thức đó không trở thành mô tả về đối tượng. Tương tự, các khía cạnh của giá trị trả về không phải là URI. Đối tượng vẫn là một cái gì đó và không phải là một cái gì đó hoặc một cái gì đó

Giả sử nếu bạn không muốn sử dụng tiêu đề Chấp nhận, nhưng nếu bạn vẫn muốn thực sự là REST về mặt triết học, tôi sẽ không bận tâm điều gì đó như:

GET /api/something?parm1=value1&return_type=xml

như trái ngược với

GET /api/something.xml?parm1=value1 (or /api/something.json?param1=value1)

Nhưng như tôi đã nói, sự khác biệt này chỉ là triết học.

@vartec: Tôi nghĩ bạn sai

Nguyên tắc RESTful chính thức phù hợp nói rằng không có gì phải được ẩn trong các tiêu đề HTTP vì đó là URI được hiển thị hoặc được tham chiếu, mọi chi tiết về yêu cầu / phản hồi phải được cung cấp như một phần của URI

Do đó, tôi thực sự khuyên bạn nên tránh sử dụng tiêu đề để biết chi tiết về yêu cầu và phản hồi và bám sát

 GET /api/something.xml?parm1=value1 (or /api/something.json?param1=value1)

Tôi không thể tìm thấy các tài liệu tham khảo một cách nhanh chóng, nhưng tôi sẽ đăng lại cùng với họ (thực ra bạn có thể tham khảo cuốn sách xuất bản O'reilly "Dịch vụ web RESTful" ( http://shop.oreilly.com/product/9780596529260.do ) xác nhận tương tự