云真机

API接口文档


主动加好友

<h5>简要描述</h5> <ul> <li>此接口仅为支持智域管家.云真机网页端的功能:【主动加好友——按手机号手动输入功能】。通过API往网页上添加任务,执行状态和结果需到网页查看,该接口没有结果回调。</li> <li>若要自行实现加好友功能,可使用下发指令【&lt;a href=&quot;<a href="https://www.showdoc.com.cn/yunzhenji/11490698131402110#contactAdd&quot;&gt;添加联系人&lt;/a&gt;】,该指令下发后有结果回调">https://www.showdoc.com.cn/yunzhenji/11490698131402110#contactAdd&quot;&gt;添加联系人&lt;/a&gt;】,该指令下发后有结果回调</a>。</li> </ul> <h5>请求URL</h5> <ul> <li><code>https://oapi-yzj.miaokol.com/index/addBuddy</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> </ul> <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;">app_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>APP ID</td> </tr> <tr> <td style="text-align: left;">access_token</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>Access Token</td> </tr> <tr> <td style="text-align: left;">corp_id</td> <td style="text-align: left;">是</td> <td style="text-align: left;">int</td> <td>企业id</td> </tr> <tr> <td style="text-align: left;">group_id</td> <td style="text-align: left;">否</td> <td style="text-align: left;">int</td> <td>分组id,默认0表示未分组</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">是</td> <td style="text-align: left;">array</td> <td>手机号,如: [&quot;130xxxxxxxx&quot;]、 [&quot;130xxxxxxxx&quot;,&quot;131xxxxxxxx&quot;]</td> </tr> <tr> <td style="text-align: left;">tags</td> <td style="text-align: left;">否</td> <td style="text-align: left;">array</td> <td>标签,如: [&quot;14073749806653305&quot;]、[&quot;14073749806653305&quot;,&quot;14073749890603286&quot;]</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code>POST /index/addBuddy HTTP/1.1 Host:oapi-yzj.miaokol.com Content-Type: application/json; charset=UTF-8 { &amp;quot;app_id&amp;quot;:&amp;quot;xxx&amp;quot;, &amp;quot;access_token&amp;quot;:&amp;quot;xxx&amp;quot;, &amp;quot;corp_id&amp;quot;:&amp;quot;xxxx&amp;quot;, &amp;quot;group_id&amp;quot;:&amp;quot;xxxx&amp;quot;, &amp;quot;data&amp;quot;: [&amp;quot;130xxxxxxxx&amp;quot;], &amp;quot;tags&amp;quot;: [“14073749806653305”], } </code></pre> <h5>响应示例</h5> <pre><code>HTTP/1.1 200 OK { &amp;quot;task_id&amp;quot;:1,     &amp;quot;errcode&amp;quot;:0 } </code></pre> <h5>响应说明</h5> <ul> <li>数组项格式说明如下</li> </ul> <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;">errcode</td> <td style="text-align: left;">int</td> <td>该为0表示参数校验成功,主动加好友任务已创建,任务的执行状态和结果请到网页端查看; 该值非0表示任务创建失败,失败信息在message返回</td> </tr> <tr> <td style="text-align: left;">message</td> <td style="text-align: left;">string</td> <td></td> </tr> </tbody> </table>

页面列表

ITEM_HTML