问卷星开放文档

问卷星开放文档


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个用户体系的参与者,支持多次调用;&lt;br&gt;参与者对象:&lt;a href=&quot;#2.6.2.1.1&quot;&gt;2.6.2.1.1参与者对象(user)&lt;/a&gt;</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:不创建 &lt;br&gt;1或true:创建 &lt;br&gt;默认值为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:不创建&lt;br&gt;1或true:创建&lt;br&gt;默认值为0</td> </tr> </tbody> </table> <p>&lt;div id=&quot;2.6.2.1.1&quot;&gt;&lt;/div&gt;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>鉴别用户的唯一身份编号&lt;br&gt;不允许重复。</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 {  &amp;quot;action&amp;quot;: &amp;quot;1005002&amp;quot;,   &amp;quot;corpid&amp;quot;: &amp;quot;org0000000907&amp;quot;,  &amp;quot;appid&amp;quot;: &amp;quot;907&amp;quot;,  &amp;quot;auto_create_udept&amp;quot;: &amp;quot;1&amp;quot;,  &amp;quot;auto_create_tag&amp;quot;: &amp;quot;1&amp;quot;,  &amp;quot;sign&amp;quot;: &amp;quot;75a6656da9a76e8fa379c50e47011a01d80f737a&amp;quot;,  &amp;quot;ts&amp;quot;: &amp;quot;1594104028&amp;quot;,  &amp;quot;users&amp;quot;: &amp;quot;[{\&amp;quot;userid\&amp;quot;:\&amp;quot;18565886123\&amp;quot;,\&amp;quot;name\&amp;quot;:\&amp;quot;测试2\&amp;quot;,\&amp;quot;nickname\&amp;quot;:\&amp;quot;昵称测试2\&amp;quot;,\&amp;quot;mobile\&amp;quot;:\&amp;quot;18565886123\&amp;quot;,\&amp;quot;email\&amp;quot;:\&amp;quot;12333@qq.ocm\&amp;quot;,\&amp;quot;department\&amp;quot;:\&amp;quot;研发/后端2\&amp;quot;,\&amp;quot;birthday\&amp;quot;:\&amp;quot;1992-10-02\&amp;quot;,\&amp;quot;gender\&amp;quot;:\&amp;quot;1\&amp;quot;,\&amp;quot;education\&amp;quot;:\&amp;quot;4\&amp;quot;,\&amp;quot;marriage\&amp;quot;:\&amp;quot;2\&amp;quot;,\&amp;quot;family\&amp;quot;:\&amp;quot;2\&amp;quot;,\&amp;quot;tags\&amp;quot;:\&amp;quot;123/10032\&amp;quot;,\&amp;quot;pwd\&amp;quot;:\&amp;quot;2\&amp;quot;}]&amp;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">{ &amp;quot;result&amp;quot;: true }</code></pre> <p>示例响应参数2:</p> <pre><code class="language-csharp">{ &amp;quot;result&amp;quot;: false, &amp;quot;errormsg&amp;quot;: &amp;quot;参数错误&amp;quot; }</code></pre>

页面列表

ITEM_HTML