里程碑的列表页
<p>欢迎使用ShowDoc!</p>
<p><strong>简要描述:</strong> </p>
<ul>
<li>里程碑的列表页</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>127.0.0.1:3000/api/projects/3072/versions.json</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>GET </li>
</ul>
<p><strong>参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">project_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>项目的id</td>
</tr>
<tr>
<td style="text-align: left;">page</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>分页数</td>
</tr>
<tr>
<td style="text-align: left;">order_type</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>排序方式,默认为:desc(降序),可选:asc(升序)</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>里程碑的筛选状态,默认为空,可选值为:open, closed, locked</td>
</tr>
<tr>
<td style="text-align: left;">order_name</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>里程碑的排序值,默认为“created_on", "issues_count"表示工单数量, "percent"表示完成度</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"versions_count": 4, #里程碑的数量
"open_count": 1, #开启的里程碑数量
"closed_count": 3, #关闭的里程碑数量
"versions": [
{
"id": 459, #里程碑的id
"name": "licheng44", #里程碑的名称
"description": "cdeshi dfdaf", #里程碑的描述
"effective_date": "2020-01-30", #里程碑的截止时间
"status": "open", #里程碑的状态
"open_issues_count": 0, #已开启的issue数量
"close_issues_count": 0, #已关闭的issue数量
"created_at": "2019-12-24 17:57", #里程碑创建时间
"updated_at": "2019-12-24 17:57", #更新时间
"user_name": "线上导师", #创建人的姓名
"user_login": "innov" #创建人的login
},
{
"id": 458,
"name": "licheng33",
"description": "cdeshi dfdaf",
"effective_date": "2019-12-30",
"status": "open",
"open_issues_count": 0,
"close_issues_count": 0,
"created_at": "2019-12-24 17:56",
"updated_at": "2019-12-24 17:56",
"user_name": "线上导师",
"user_login": "innov"
},
{
"id": 457,
"name": "licheng22",
"description": "cdeshi dfdaf",
"effective_date": "2019-12-30",
"status": "open",
"open_issues_count": 0,
"close_issues_count": 0,
"created_at": "2019-12-24 17:56",
"updated_at": "2019-12-24 17:56",
"user_name": "线上导师",
"user_login": "innov"
},
{
"id": 456,
"name": "licheng11",
"description": "cdeshi dfdaf",
"effective_date": "2019-12-30",
"status": "open",
"open_issues_count": 0,
"close_issues_count": 0,
"created_at": "2019-12-24 17:56",
"updated_at": "2019-12-24 17:56",
"user_name": "线上导师",
"user_login": "innov"
}
]
}</code></pre>
<p><strong>返回参数说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">groupid</td>
<td style="text-align: left;">int</td>
<td>用户组id,1:超级管理员;2:普通用户</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>