2.3.1 添加参与者[1002001]
<p>[TOC]</p>
<h1>接口地址</h1>
<p>生产环境:<code>https://www.wjx.cn/openapi/usersystem.aspx</code></p>
<ul>
<li>
<h1>2.3.1.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;">sysid</td>
<td style="text-align: left;">用户体系唯一编号</td>
<td>int</td>
<td>是</td>
<td>为固定值,可在创建完用户体系后在参与者主页登录地址中找到</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:不创建<br>1:创建<br>默认值为0</td>
</tr>
<tr>
<td style="text-align: left;">users</td>
<td style="text-align: left;">参与者列表</td>
<td>String(user[])</td>
<td>是</td>
<td>最多允许批量添加100个用户体系的参与者,支持多次调用;<br>参与者对象:<a href="#2.3.1.1.1">2.3.1.1.1参与者对象(user)</a><br>需要将user[]对象转为string</td>
</tr>
</tbody>
</table>
<div id="2.3.1.1.1"></div>2.3.1.1.1参与者对象(user)
|参数|参数名|类型|必需|备注|
|:--- |:------ |--- |-|-------- |
|uid |参与者唯一编号 |string |是 |鉴别参与者的唯一身份编号<br>同一用户体系下不允许重名;<br>只能包含大小写字母、数字、中文;<br>不能包含任何特殊字符;<br>不能超过30个字符;
|uname |参与者的姓名 |string |否 |同一用户体系下允许重名<br>只能包含大小写字母、数字、中文;<br>不能超过30个字符;|
|upass |参与者的初始登录密码 |string |否 |用于参与者手动登录,传递后会加密存储,用户体系需要添加此字段,否则接口传入也会被舍弃<br>不能超过50个字符;<br>只能包含大小写字母、数字、!@#$%^&*()_?<>{}特殊字符;|
|udept |参与者的部门 |String[] |否 |用户体系需要添加此字段,否则接口传入也会被舍弃<br>多级部门从属关系按序号排列;<br>最多支持4级部门;<br>单级部门不能超过50个字符;<br>字符串“(”会自动转化为“(”;<br>字符串“)”会自动转化为“)”;|
|uextf |参与者的附加信息 |string[] |否 |用户体系需要添加此字段,否则接口传入也会被舍弃<br>单个附加信息不能超过50个字符;<br>最多支持10个附加信息;<br>只能包含大小写字母、数字、中文;|
- 举例
```csharp
Content-Type:application/json
{
"action": "1002001",
"appid": "907",
"auto_create_udept": "1",
"sign": "75a6656da9a76e8fa379c50e47011a01d80f737a",
"sysid": "103658",
"ts": "1594104028",
"users": "[{\"uid\":\"1\",\"uname\":\"c1\",\"upass\":\"123\",\"udept\":[\"a1\",\"b1\",\"c1\"]},{\"uid\":\"2\",\"uname\":\"c2\",\"upass\":\"123\",\"udept\":[\"a1\",\"b1\",\"c1\"]},{\"uid\":\"3\",\"uname\":\"c3\",\"upass\":\"123\",\"udept\":[\"a1\",\"b1\",\"c2\"]}]"
}
```
# 2.3.2.2响应参数列表
|参数|类型|说明|必需|备注|
|:--- |:------ |--- |-|-------- |
| | | | ||