华峰系统对接

采销系统对接文档


部门数据同步/批量新增

<p>[TOC]</p> <h5>简要描述</h5> <ul> <li>部门数据同步接口</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://10.1.7.164:8112/open/docking/user/saveDept</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> <li>application/json</li> </ul> <h5>header参数</h5> <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;">appId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>对接appId</td> </tr> <tr> <td style="text-align: left;">token</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>认证token</td> </tr> </tbody> </table> <h5>body参数示例</h5> <pre><code>[{ &amp;quot;departmentName&amp;quot;: &amp;quot;测试部门&amp;quot;, &amp;quot;departmentCode&amp;quot;: &amp;quot;22222&amp;quot;, &amp;quot;companyCode&amp;quot;:&amp;quot;11111&amp;quot;, &amp;quot;status&amp;quot;: &amp;quot;01&amp;quot; }]</code></pre> <h5>body参数说明</h5> <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;">departmentName</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>部门名称</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>部门状态:01-启用,02-禁用</td> </tr> <tr> <td style="text-align: left;">departmentCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>部门编号</td> </tr> <tr> <td style="text-align: left;">companyCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>hr编码,对应企业表中的compCode字段</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{ &amp;quot;ret&amp;quot;: &amp;quot;200&amp;quot;, &amp;quot;msg&amp;quot;: &amp;quot;请求成功&amp;quot;, &amp;quot;data&amp;quot;: true, &amp;quot;timestamp&amp;quot;: 1706761326015, &amp;quot;requestId&amp;quot;: &amp;quot;E1706761326014&amp;quot; }</code></pre> <h5>返回参数说明</h5> <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;">ret</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>响应码</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>响应码描述</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Boolean</td> <td>业务是否执行成功,true-成功,false-失败</td> </tr> <tr> <td style="text-align: left;">timestamp</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Long</td> <td>响应时间戳</td> </tr> <tr> <td style="text-align: left;">requestId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>请求ID</td> </tr> </tbody> </table> <h5>备注</h5> <ul> <li> <p>若业务执行失败,会使用请求参数重试,若依旧失败,采销系统会做记录,该记录是否需要回传给用户中心。</p> </li> <li>接口共用之前的代码,属于迭代循环保存,建议小数量发起请求,从而规避内存爆满及效率过低的问题。</li> </ul>

页面列表

ITEM_HTML