我应该使用什么媒体类型在我的RESTful API中提供zip存档中包含的pdf文件?

时间:2016-08-23 15:00:04

标签: rest http http-headers mime-types

我正在构建一个HTTP RESTful API,我的操作包括在mongo数据库中获取以JSON格式定义的资源,并将其返回到客户端要求的格式。

根据客户的选择,说路线GET /api/media/{mediaId}应该能够以下列格式发送媒体:

  • jsonxmlhtmlpdf
  • ziptartar.gz(对于每种归档类型,包含的文件可以是jsonxml,{{1} }或html文件,再次,根据客户选择)

所以我将服务器编码为读取pdf请求标头,以提供匹配的媒体类型。

对于这些格式:

  • 请求Accept文件:json
  • 请求Accept: application/json文件:xml
  • 请求Accept: application/xml文件:html
  • 请求Accept: application/html文件:pdf

但是我为存档格式选择正确的媒体类型时遇到问题(Accept: application/pdfziptar

以下解决方案是否可以接受?

  • 包含tar.gz个文件的zip个文件:json
  • 包含application/zip+json个文件的zip个文件:xml
  • 包含application/zip+xml个文件的zip个文件:html
  • 包含application/zip+html个文件的zip个文件:pdf
  • 包含application/zip+pdf个文件的tar个文件:json
  • 包含application/tar+json个文件的tar个文件:xml
  • 包含application/tar+xml个文件的tar个文件:html
  • 包含application/tar+html个文件的tar个文件:pdf

...

或者我应该使用供应商树?

  • 请求包含application/tar+pdf个文件的zip文件:json

... - 请求包含Accept: application/vnd.mycompany.zip+json个文件的tar文件:pdf ...

...或者我应该使用其他语法?

0 个答案:

没有答案