版本¶

• 目录
• 版本
  • /projects/:project_id/versions.:format
    • GET
    • POST
  • /versions/:id.:format
    • GET
    • PUT
    • DELETE

/projects/:project_id/versions.:format¶

GET¶

返回给定id或标识符的项目可用的版本。响应可能包括来自其他项目的共享版本。

示例:

GET /projects/foo/versions.xml
GET /projects/1/versions.xml

响应:

<?xml version="1.0" encoding="UTF-8"?>
<versions type="array" total_count="34">
  <version>
    <id>1</id>
    <project name="Redmine" id="1"/>
    <name>0.7</name>
    <description/>
    <status>closed</status>
    <due_date>2008-04-28</due_date>
    <sharing>none</sharing>
    <created_on>2008-03-09T12:52:06+01:00</created_on>
    <updated_on>2009-11-15T12:22:12+01:00</updated_on>
    <wiki_page_title>FooBarWikiPage</version_wiki_page_title>
  </version>
  <version>
    <id>2</id>
    <project name="Redmine" id="1"/>
    <name>0.8</name>
    <description/>
    <status>closed</status>
    <due_date>2008-12-30</due_date>
    <sharing>none</sharing>
    <wiki_page_title>FooBarWikiPage</version_wiki_page_title>
    <created_on>2008-03-09T12:52:12+01:00</created_on>
    <updated_on>2009-11-15T12:22:12+01:00</updated_on>
  </version>
</versions>

POST¶

为给定id或标识符的项目创建一个版本。

参数:

• version (必需): 版本属性的哈希，包括
  • name (必需)
  • status: 版本状态：在open (默认), locked, closed
  • sharing: 版本共享方式：在none (默认), descendants, hierarchy, tree, system
  • due_date
  • description
  • wiki_page_title

响应:

• 201 Created: 版本已创建
• 422 Unprocessable Entity: 由于验证失败，版本未创建（响应体包含错误消息）

/versions/:id.:format¶

GET¶

返回给定id的版本。

示例:

GET /versions/2.xml

响应:

<?xml version="1.0" encoding="UTF-8"?>
<version>
  <id>2</id>
  <project name="Redmine" id="1"/>
  <name>0.8</name>
  <description/>
  <status>closed</status>
  <due_date>2008-12-30</due_date>
  <estimated_hours>0.0</estimated_hours>
  <spent_hours>0.0</spent_hours>
  <created_on>2008-03-09T12:52:12+01:00</created_on>
  <updated_on>2009-11-15T12:22:12+01:00</updated_on>
</version>

PUT¶

更新给定id的版本。

参数:

与版本创建相同

响应:

• 204 No Content: 版本已更新
• 422 Unprocessable Entity: 由于验证失败，版本未更新（响应体包含错误消息）

DELETE¶

删除给定id的版本。

响应:

• 204 No Content: 版本已删除
• 422 Unprocessable Entity: 由于验证失败，版本未删除（响应体包含错误消息）