RESTful设计-如何为实体的附件建模

我想知道我应该如何对它进行RESTful建模

我考虑了以下两种选择:

第一种方法(使用相同的资源、不同的表示):

• 获取,内容类型:上的XML http://my-app/defects/ {id}/附件 将返回缺陷的

• 获取,内容类型:gzip on http://my-app/defects/ 将在zip文件中返回缺陷的附件

• 获取,内容类型:mime多部分打开 http://my-app/defects/ {id}/附件 将以多部分消息(二进制数据和XML元数据)的形式返回缺陷的附件

• POST,内容类型:上的XML http://my-app/defects/ {id}/附件

• 帖子,内容类型:mime\multi-part on {id}/附件 如果要创建附件,客户端可以在一次往返中发送元数据和文件本身

第二种方法(将附件的数据与元数据分开):

• http://my-app/defects/ {id}/附件 将返回缺陷的

• 获取,内容类型:gzip on http://my-app/defects/ {id}/附件/文件 将在单个zip中返回缺陷的附件二进制数据

• POST,内容类型:上的XML 将创建新附件,仅元数据不附加任何文件(然后用户必须使用二进制数据发送PUT请求)

然后添加二进制数据本身:

• http://my-app/defects/ {id}/attachments/{id}/file 将创建附件文件

编辑: flicker upload REST API . 他们似乎在使用多部分消息来包含照片和照片属性。