2017-09-04 11:50:36 +08:00
|
|
|
|
<!DOCTYPE html>
|
|
|
|
|
<html lang="zh-CN">
|
|
|
|
|
|
|
|
|
|
<head>
|
|
|
|
|
<meta charset="UTF-8">
|
|
|
|
|
<meta name="viewport" content="width=device-width,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no" />
|
|
|
|
|
<meta name="format-detection" content="telephone=no,email=no" />
|
|
|
|
|
<meta http-equiv="X-UA-Compatible" content="ie=edge, chrome=1">
|
|
|
|
|
<meta name="description" content="description of your site">
|
|
|
|
|
<meta name="author" content="author of the site">
|
|
|
|
|
<title>YApi 使用手册</title>
|
2017-09-07 18:44:50 +08:00
|
|
|
|
<link rel="stylesheet" href="source/main.css" />
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="styles/theme.css" />
|
|
|
|
|
|
|
|
|
|
|
2017-09-04 11:50:36 +08:00
|
|
|
|
</head>
|
|
|
|
|
<body>
|
|
|
|
|
<div class="ydoc">
|
|
|
|
|
<header class="ydoc-header">
|
|
|
|
|
<div class="ydoc-header-area">
|
|
|
|
|
|
|
|
|
|
<a href="http://ued.qunar.com/ymfe/" class="navbar-brand">YMFE</a>
|
|
|
|
|
|
|
|
|
|
<button class="ydocIcon navbar-toggle"></button>
|
|
|
|
|
<nav class="ydoc-nav">
|
|
|
|
|
<ul class="navbar-left">
|
|
|
|
|
|
|
|
|
|
<li class="active">
|
|
|
|
|
|
2017-09-12 11:58:22 +08:00
|
|
|
|
<a href="index.html">使用手册</a>
|
2017-09-04 11:50:36 +08:00
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li class="">
|
|
|
|
|
|
|
|
|
|
<a href="api.html"></a>
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
</nav>
|
|
|
|
|
</div>
|
|
|
|
|
</header>
|
|
|
|
|
|
|
|
|
|
<!-- <header style="height:20px"></header> -->
|
|
|
|
|
|
|
|
|
|
<!-- Docs page layout -->
|
|
|
|
|
|
|
|
|
|
<div class="ydoc-banner-bg">
|
|
|
|
|
<div class="ydoc-banner ">
|
|
|
|
|
<div class="ydoc-banner-area">
|
|
|
|
|
<h1 >YApi</h1>
|
|
|
|
|
<p class="desc ">高效、易用、功能强大的api管理平台,旨在为开发、产品、测试人员提供更优雅的接口管理服务。</p>
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="ydoc-container">
|
|
|
|
|
|
2017-09-07 18:44:50 +08:00
|
|
|
|
<div class="ydoc-container-content ">
|
2017-09-04 11:50:36 +08:00
|
|
|
|
|
|
|
|
|
|
2017-09-07 18:44:50 +08:00
|
|
|
|
<div class="content-left staticsidenav" role="complementary">
|
2017-09-04 11:50:36 +08:00
|
|
|
|
<nav class="docs-sidebar hidden-print hidden-xs hidden-sm">
|
|
|
|
|
<ul class="nav docs-sidenav">
|
|
|
|
|
|
|
|
|
|
<!-- <li > -->
|
|
|
|
|
<li >
|
|
|
|
|
|
2017-09-12 11:58:22 +08:00
|
|
|
|
<a href="index-认识 YApi.html">认识 YApi</a>
|
2017-09-04 11:50:36 +08:00
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<!-- <li > -->
|
|
|
|
|
<li >
|
|
|
|
|
|
2017-09-12 11:58:22 +08:00
|
|
|
|
<a href="index-创建第一个API.html">创建第一个API</a>
|
2017-09-04 11:50:36 +08:00
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<!-- <li class="active" class="active" > -->
|
|
|
|
|
<li class="active" >
|
|
|
|
|
|
2017-09-12 11:58:22 +08:00
|
|
|
|
<a href="index-管理分组与项目.html">管理分组与项目</a>
|
2017-09-04 11:50:36 +08:00
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<ul class="nav docs-sidenav-extend" >
|
|
|
|
|
|
|
|
|
|
<li >
|
2017-09-06 15:40:45 +08:00
|
|
|
|
<a href="#认识组长">认识组长</a>
|
2017-09-04 11:50:36 +08:00
|
|
|
|
</li>
|
|
|
|
|
|
2017-09-13 17:51:57 +08:00
|
|
|
|
<li >
|
|
|
|
|
<a href="#创建分组">创建分组</a>
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li >
|
|
|
|
|
<a href="#创建项目">创建项目</a>
|
|
|
|
|
</li>
|
|
|
|
|
|
2017-09-04 11:50:36 +08:00
|
|
|
|
<li >
|
2017-09-05 11:16:06 +08:00
|
|
|
|
<a href="#权限列表">权限列表</a>
|
2017-09-04 11:50:36 +08:00
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
<!-- <li > -->
|
|
|
|
|
<li >
|
|
|
|
|
|
2017-09-12 11:58:22 +08:00
|
|
|
|
<a href="index-项目操作.html">项目操作</a>
|
2017-09-06 15:40:45 +08:00
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<!-- <li > -->
|
|
|
|
|
<li >
|
|
|
|
|
|
2017-09-12 11:58:22 +08:00
|
|
|
|
<a href="index-接口操作.html">接口操作</a>
|
2017-09-04 11:50:36 +08:00
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<!-- <li > -->
|
|
|
|
|
<li >
|
|
|
|
|
|
2017-09-12 11:58:22 +08:00
|
|
|
|
<a href="index-使用mock功能.html">使用mock功能</a>
|
2017-09-04 11:50:36 +08:00
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<!-- <li > -->
|
|
|
|
|
<li >
|
|
|
|
|
|
2017-09-12 11:58:22 +08:00
|
|
|
|
<a href="index-使用测试集.html">使用测试集</a>
|
2017-09-04 11:50:36 +08:00
|
|
|
|
</li>
|
2017-09-13 17:51:57 +08:00
|
|
|
|
|
|
|
|
|
<!-- <li > -->
|
|
|
|
|
<li >
|
|
|
|
|
|
|
|
|
|
<a href="index-常见问题.html">常见问题</a>
|
|
|
|
|
</li>
|
2017-09-04 11:50:36 +08:00
|
|
|
|
|
|
|
|
|
</ul>
|
|
|
|
|
</nav>
|
|
|
|
|
</div>
|
|
|
|
|
|
2017-09-07 18:44:50 +08:00
|
|
|
|
<div class="content-right markdown-body use-sidebar" role="main">
|
2017-09-04 11:50:36 +08:00
|
|
|
|
|
2017-09-06 15:40:45 +08:00
|
|
|
|
<p>接口管理的逻辑较为复杂,操作频率高,层层审批将严重拖慢生产效率,因此传统的金字塔管理模式并不适用。</p>
|
2017-09-13 11:55:53 +08:00
|
|
|
|
<p>YApi 将扁平化管理模式的思想引入到产品的权限管理中,<code>超级管理员</code> 拥有最高的权限,并将权限分配给若干 <code>组长</code>,<code>超级管理员</code> 只需管理<code>组长</code> 即可,实际上管理YAPI各大分组与项目的是“<code>组长</code>”。<code>组长</code>对分组或项目负责,一般由BU负责人/项目负责人担任。</p>
|
2017-09-06 15:40:45 +08:00
|
|
|
|
<h2 class="subject" id="认识组长">认识组长 <a class="hashlink" href="#认识组长">#</a></h2><p>组长分为 <code>分组组长</code> 与 <code>项目组长</code>,组长对分组或项目负责,拥有分组或项目下的所有权限,二者区别如下:</p>
|
|
|
|
|
<p><code>分组组长</code> 有权限修改分组、删除分组,可以创建分组下的项目。一般来说,组长只需要对项目负责,将项目的操作任务安排给项目组长处理即可。</p>
|
|
|
|
|
<p><code>项目组长</code> 无法操作分组,但拥有项目的全部权限,<code>项目组长</code> 是 YApi 的基层管理者,承担了 YApi 绝大部分的日常管理工作。</p>
|
2017-09-13 17:51:57 +08:00
|
|
|
|
<h2 class="subject" id="创建分组">创建分组 <a class="hashlink" href="#创建分组">#</a></h2><p>只有 <code>超级管理员</code> 有权限创建分组</p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>联系超级管理员<code>(Qtalk: wenbo.dong; wenxiong.su; wenjie.zhang.)</code>,说明要创建的分组名称和自己的用户名。</li><li>分组一般以 BU 作为维度。</li></ul>
|
2017-09-14 15:13:46 +08:00
|
|
|
|
<h2 class="subject" id="创建项目">创建项目 <a class="hashlink" href="#创建项目">#</a></h2><p>成为 <code>分组成员</code>,即可在分组中创建项目。</p>
|
2017-09-13 17:51:57 +08:00
|
|
|
|
<p><img src="./images/usage/manage_ask_group.png" /></p>
|
2017-09-14 15:13:46 +08:00
|
|
|
|
<blockquote>
|
|
|
|
|
<p>想成为 <code>分组组长</code> ,在分组成员列表中找到 <code>分组组长</code>,联系 <code>分组组长</code> 将你设置为分组组长。</p>
|
|
|
|
|
</blockquote>
|
2017-09-13 17:51:57 +08:00
|
|
|
|
<p><a href="./index-常见问题.html#Q__怎样联系组长?">怎样联系组长?</a></p>
|
|
|
|
|
<h2 class="subject" id="权限列表">权限列表 <a class="hashlink" href="#权限列表">#</a></h2><p>新用户未加入项目或分组时,我们称为 <code>“游客”</code>。</p>
|
2017-09-13 11:55:53 +08:00
|
|
|
|
<h3 class="subject" id="项目权限">项目权限 <a class="hashlink" href="#项目权限">#</a></h3><table>
|
2017-09-06 14:25:12 +08:00
|
|
|
|
<thead>
|
|
|
|
|
<tr>
|
|
|
|
|
<th style="text-align:left">操作</th>
|
2017-09-06 15:51:05 +08:00
|
|
|
|
<th style="text-align:center">游客</th>
|
2017-09-13 11:55:53 +08:00
|
|
|
|
<th style="text-align:center">项目开发者</th>
|
|
|
|
|
<th style="text-align:center">项目组长</th>
|
2017-09-06 15:51:05 +08:00
|
|
|
|
<th style="text-align:center">超级管理员</th>
|
2017-09-06 14:25:12 +08:00
|
|
|
|
</tr>
|
|
|
|
|
</thead>
|
|
|
|
|
<tbody>
|
|
|
|
|
<tr>
|
2017-09-06 15:51:05 +08:00
|
|
|
|
<td style="text-align:left">浏览公开项目与接口</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td style="text-align:left">浏览私有项目与接口</td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td style="text-align:left">编辑项目信息</td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td style="text-align:left">新建接口</td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td style="text-align:left">编辑接口</td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td style="text-align:left">编辑项目头像</td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td style="text-align:left">删除项目</td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
2017-09-06 14:25:12 +08:00
|
|
|
|
</tr>
|
|
|
|
|
</tbody>
|
|
|
|
|
</table>
|
|
|
|
|
<h3 class="subject" id="分组权限">分组权限 <a class="hashlink" href="#分组权限">#</a></h3><table>
|
|
|
|
|
<thead>
|
|
|
|
|
<tr>
|
|
|
|
|
<th style="text-align:left">操作</th>
|
2017-09-06 15:51:05 +08:00
|
|
|
|
<th style="text-align:center">游客</th>
|
2017-09-14 15:13:46 +08:00
|
|
|
|
<th style="text-align:center">分组开发者</th>
|
2017-09-13 11:55:53 +08:00
|
|
|
|
<th style="text-align:center">分组组长</th>
|
2017-09-06 15:51:05 +08:00
|
|
|
|
<th style="text-align:center">超级管理员</th>
|
2017-09-06 14:25:12 +08:00
|
|
|
|
</tr>
|
|
|
|
|
</thead>
|
|
|
|
|
<tbody>
|
|
|
|
|
<tr>
|
|
|
|
|
<td style="text-align:left">浏览分组</td>
|
2017-09-06 15:51:05 +08:00
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
2017-09-06 14:25:12 +08:00
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2017-09-06 15:51:05 +08:00
|
|
|
|
<td style="text-align:left">在分组中新建项目</td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
2017-09-06 14:25:12 +08:00
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
2017-09-06 15:51:05 +08:00
|
|
|
|
<td style="text-align:left">编辑分组信息</td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
2017-09-06 14:25:12 +08:00
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td style="text-align:left">管理分组成员</td>
|
2017-09-06 15:51:05 +08:00
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
2017-09-06 14:25:12 +08:00
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td style="text-align:left">删除分组</td>
|
2017-09-06 15:51:05 +08:00
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center"></td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
|
|
|
|
<td style="text-align:center">✓</td>
|
2017-09-06 14:25:12 +08:00
|
|
|
|
</tr>
|
|
|
|
|
</tbody>
|
|
|
|
|
</table>
|
|
|
|
|
|
2017-09-04 11:50:36 +08:00
|
|
|
|
</div>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<footer class="footer">
|
|
|
|
|
<div class="copyright">
|
|
|
|
|
© 2016 <a href="http://ued.qunar.com/ymfe/">YMFE</a> Team. Build by <a href="http://ued.qunar.com/ydoc/">ydoc</a>.
|
|
|
|
|
</div>
|
|
|
|
|
</footer>
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="open-panel"></div>
|
|
|
|
|
<div class="mask"></div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<script src="source/main.js"></script>
|
|
|
|
|
<script src="source/app.js"></script>
|
|
|
|
|
|
|
|
|
|
<script>
|
2017-09-07 18:44:50 +08:00
|
|
|
|
var lineHeight = 18;
|
2017-09-04 11:50:36 +08:00
|
|
|
|
var EXAMPLE_MAX_HEIGHT;
|
|
|
|
|
|
|
|
|
|
function fold() {
|
|
|
|
|
// 折叠code
|
|
|
|
|
$('.markdown-body pre').css({
|
|
|
|
|
"line-height": lineHeight + "px"
|
|
|
|
|
});
|
|
|
|
|
$('.markdown-body pre').map(function(i, item) {
|
|
|
|
|
var $item = $(item);
|
|
|
|
|
var foldnumber = $item.data('foldnumber');
|
|
|
|
|
EXAMPLE_MAX_HEIGHT = lineHeight * (foldnumber || 6);
|
|
|
|
|
if ($item.height() > EXAMPLE_MAX_HEIGHT) {
|
|
|
|
|
$item.css({
|
|
|
|
|
"padding-bottom": 30
|
|
|
|
|
});
|
|
|
|
|
$item.find('code').height(EXAMPLE_MAX_HEIGHT);
|
|
|
|
|
$item.append('<span class="extend">展开更多……</span>');
|
|
|
|
|
};
|
|
|
|
|
});
|
|
|
|
|
$('.ydoc-example').delegate('.extend', 'click', function() {
|
|
|
|
|
var $this = $(this);
|
|
|
|
|
$this.removeClass('extend').addClass('fold');
|
|
|
|
|
$this.html('折叠代码');
|
2017-09-07 18:44:50 +08:00
|
|
|
|
$this.parent().children('.js-code').height('auto');
|
|
|
|
|
$this.parent().height('auto');
|
2017-09-04 11:50:36 +08:00
|
|
|
|
});
|
|
|
|
|
$('.ydoc-example').delegate('.fold', 'click', function() {
|
|
|
|
|
var $this = $(this);
|
|
|
|
|
var foldnumber = $this.parent().data('foldnumber');
|
|
|
|
|
EXAMPLE_MAX_HEIGHT = lineHeight * (foldnumber || 6);
|
|
|
|
|
$this.removeClass('fold').addClass('extend');
|
|
|
|
|
$this.parent().height(EXAMPLE_MAX_HEIGHT); // pre
|
2017-09-07 18:44:50 +08:00
|
|
|
|
$this.parent().children('.js-code').height(EXAMPLE_MAX_HEIGHT); // code
|
2017-09-04 11:50:36 +08:00
|
|
|
|
$this.html("展开更多……");
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
$(document).ready(fold);
|
|
|
|
|
</script>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
|
|
|
|
|
</html>
|