明道企业授权开放接口文档

明道企业授权开放接口文档


根据账号添加汇报关系

<p><strong>简要描述:</strong> </p> <ul> <li>根据账号添加汇报关系</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>{Host}/v2/open/structure/addStructures</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST (application/json)</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;">superior</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>上级的邮箱或手机号,不传则代表添加到顶级</td> </tr> <tr> <td style="text-align: left;">subordinates</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string[]</td> <td>下级成员的邮箱或手机号集合</td> </tr> </tbody> </table> <p><strong>提交数据示例</strong></p> <pre><code>{ &amp;quot;superior&amp;quot;: &amp;quot;string&amp;quot;, &amp;quot;subordinates&amp;quot;: [ &amp;quot;string&amp;quot; ], &amp;quot;appKey&amp;quot;: &amp;quot;string&amp;quot;, &amp;quot;sign&amp;quot;: &amp;quot;string&amp;quot;, &amp;quot;timestamp&amp;quot;: 0, &amp;quot;projectId&amp;quot;: &amp;quot;string&amp;quot; }</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;">success</td> <td style="text-align: left;">bool</td> <td>操作是否成功</td> </tr> <tr> <td style="text-align: left;">error_code</td> <td style="text-align: left;">int</td> <td>错误代码,1代表成功</td> </tr> <tr> <td style="text-align: left;">error_msg</td> <td style="text-align: left;">string</td> <td>错误消息</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">Object[]</td> <td>部分添加失败的下级成员集</td> </tr> <tr> <td style="text-align: left;">failCode</td> <td style="text-align: left;">int</td> <td>10001 员工已离职 10002 汇报关系已存在</td> </tr> </tbody> </table> <p><strong>处理成功 返回数据示例</strong></p> <pre><code>{ &amp;quot;error_code&amp;quot;: 1, &amp;quot;success&amp;quot;: true }</code></pre> <p><strong>部分添加失败 返回数据示例</strong></p> <pre><code>{ &amp;quot;data&amp;quot;: [ { &amp;quot;accountId&amp;quot;: &amp;quot;xxx&amp;quot;, &amp;quot;failCode&amp;quot;: 10001 }], &amp;quot;error_code&amp;quot;: 1, &amp;quot;success&amp;quot;: true }</code></pre> <p><strong>处理失败</strong></p> <pre><code>{ &amp;quot;error_msg&amp;quot;: &amp;quot;错误描述&amp;quot;, &amp;quot;error_code&amp;quot;: 10, &amp;quot;success&amp;quot;: false }</code></pre>

页面列表

ITEM_HTML