2.6.1 添加或更新成员[1005002]
<p>[TOC]</p>
<h1>接口地址</h1>
<p>生产环境:<code>https://www.wjx.cn/openapi/contacts.aspx</code></p>
<ul>
<li>
<h1>2.6.2.1 请求参数格式</h1>
</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">参数名</th>
<th>类型</th>
<th>必需</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">corpid</td>
<td style="text-align: left;">通讯录/联系人编号</td>
<td>string</td>
<td>是</td>
<td>通讯录/联系人编号:子账户用户名:可从管理界面中获取;</td>
</tr>
<tr>
<td style="text-align: left;">users</td>
<td style="text-align: left;">用户列表</td>
<td>user[]</td>
<td>是</td>
<td>最多允许批量修改100个用户体系的参与者,支持多次调用;<br>参与者对象:<a href="#2.6.2.1.1">2.6.2.1.1参与者对象(user)</a></td>
</tr>
<tr>
<td style="text-align: left;">auto_create_udept</td>
<td style="text-align: left;">是否自动创建部门</td>
<td>bool</td>
<td>否</td>
<td>0或false:不创建 <br>1或true:创建 <br>默认值为0</td>
</tr>
<tr>
<td style="text-align: left;">auto_create_tag</td>
<td style="text-align: left;">是否自动创建标签</td>
<td>bool</td>
<td>否</td>
<td>0或false:不创建<br>1或true:创建<br>默认值为0</td>
</tr>
</tbody>
</table>
<p><div id="2.6.2.1.1"></div>2.6.2.1.1用户对象(user)</p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">参数名</th>
<th>类型</th>
<th>必需</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">userid</td>
<td style="text-align: left;">用户唯一编号</td>
<td>string</td>
<td>是</td>
<td>鉴别用户的唯一身份编号<br>不允许重复。</td>
</tr>
<tr>
<td style="text-align: left;">name</td>
<td style="text-align: left;">姓名</td>
<td>string</td>
<td>是</td>
<td>不能超过30个字符。</td>
</tr>
<tr>
<td style="text-align: left;">nickname</td>
<td style="text-align: left;">昵称</td>
<td>string</td>
<td>否</td>
<td>不能超过50个字符。</td>
</tr>
<tr>
<td style="text-align: left;">mobile</td>
<td style="text-align: left;">手机号</td>
<td>string</td>
<td>否</td>
<td>不允许重复</td>
</tr>
<tr>
<td style="text-align: left;">email</td>
<td style="text-align: left;">邮箱</td>
<td>string</td>
<td>否</td>
<td>不允许重复</td>
</tr>
<tr>
<td style="text-align: left;">department</td>
<td style="text-align: left;">所属部门</td>
<td>string</td>
<td>否</td>
<td>上下级用‘/’隔开且从最上级开始,多部门用;(中文分号)隔开,例如:产品/设计;产品/交互。</td>
</tr>
<tr>
<td style="text-align: left;">tags</td>
<td style="text-align: left;">标签</td>
<td>string</td>
<td>否</td>
<td>组和标签用‘/’隔开,多标签用;(中文分号)隔开,例如:学历/本科;年龄/18-35。</td>
</tr>
<tr>
<td style="text-align: left;">birthday</td>
<td style="text-align: left;">生日</td>
<td>string</td>
<td>否</td>
<td>格式:yyyy-MM-dd</td>
</tr>
<tr>
<td style="text-align: left;">gender</td>
<td style="text-align: left;">性别</td>
<td>string</td>
<td>否</td>
<td>使用数字:保密 = 0,男 = 1, 女 = 2,不传或传入其他值默认为0</td>
</tr>
<tr>
<td style="text-align: left;">education</td>
<td style="text-align: left;">所属部门信息</td>
<td>string</td>
<td>否</td>
<td>保密 = 0,初中及以下 = 1,高中或中专 = 2,大学专科 = 3,大学本科 = 4,硕士及以上 = 5,不传或传入其他值默认为0</td>
</tr>
<tr>
<td style="text-align: left;">marriage</td>
<td style="text-align: left;">所属部门信息</td>
<td>string</td>
<td>否</td>
<td>保密 = 0,未婚 = 1,已婚 = 2,离异 = 3,不传或传入其他值默认为0。</td>
</tr>
<tr>
<td style="text-align: left;">family</td>
<td style="text-align: left;">所属部门信息</td>
<td>string</td>
<td>否</td>
<td>保密 = 0,没有小孩 = 1,一个小孩 = 2,两个小孩 = 3,三个小孩及以上 = 4,不传或传入其他值默认为0。</td>
</tr>
<tr>
<td style="text-align: left;">pwd</td>
<td style="text-align: left;">登录密码</td>
<td>string</td>
<td>否</td>
<td>用户使用账户密码登录场景。</td>
</tr>
</tbody>
</table>
<ul>
<li>
<p>示例请求参数:</p>
<pre><code class="language-csharp">Content-Type:application/json
{
&quot;action&quot;: &quot;1005002&quot;,
&quot;corpid&quot;: &quot;org0000000907&quot;,
&quot;appid&quot;: &quot;907&quot;,
&quot;auto_create_udept&quot;: &quot;1&quot;,
&quot;auto_create_tag&quot;: &quot;1&quot;,
&quot;sign&quot;: &quot;75a6656da9a76e8fa379c50e47011a01d80f737a&quot;,
&quot;ts&quot;: &quot;1594104028&quot;,
&quot;users&quot;: &quot;[{\&quot;userid\&quot;:\&quot;18565886123\&quot;,\&quot;name\&quot;:\&quot;测试2\&quot;,\&quot;nickname\&quot;:\&quot;昵称测试2\&quot;,\&quot;mobile\&quot;:\&quot;18565886123\&quot;,\&quot;email\&quot;:\&quot;12333@qq.ocm\&quot;,\&quot;department\&quot;:\&quot;研发/后端2\&quot;,\&quot;birthday\&quot;:\&quot;1992-10-02\&quot;,\&quot;gender\&quot;:\&quot;1\&quot;,\&quot;education\&quot;:\&quot;4\&quot;,\&quot;marriage\&quot;:\&quot;2\&quot;,\&quot;family\&quot;:\&quot;2\&quot;,\&quot;tags\&quot;:\&quot;123/10032\&quot;,\&quot;pwd\&quot;:\&quot;2\&quot;}]&quot;
}</code></pre>
</li>
<li>
<h1>2.6.2.2 响应参数列表</h1>
</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">参数名</th>
<th>类型</th>
<th>必需</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">返回状态</td>
<td>bool</td>
<td>是</td>
<td>true代表成功</td>
</tr>
<tr>
<td style="text-align: left;">errormsg</td>
<td style="text-align: left;">返回信息</td>
<td>string</td>
<td>否</td>
<td>失败返回具体信息</td>
</tr>
</tbody>
</table>
<p>示例响应参数1:</p>
<pre><code class="language-csharp">{
&quot;result&quot;: true
}</code></pre>
<p>示例响应参数2:</p>
<pre><code class="language-csharp">{
&quot;result&quot;: false,
&quot;errormsg&quot;: &quot;参数错误&quot;
}</code></pre>