主动加好友
<h5>简要描述</h5>
<ul>
<li>此接口仅为支持智域管家.云真机网页端的功能:【主动加好友——按手机号手动输入功能】。通过API往网页上添加任务,执行状态和结果需到网页查看,该接口没有结果回调。</li>
<li>若要自行实现加好友功能,可使用下发指令【<a href="<a href="https://www.showdoc.com.cn/yunzhenji/11490698131402110#contactAdd">添加联系人</a>】,该指令下发后有结果回调">https://www.showdoc.com.cn/yunzhenji/11490698131402110#contactAdd">添加联系人</a>】,该指令下发后有结果回调</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>手机号,如: ["130xxxxxxxx"]、 ["130xxxxxxxx","131xxxxxxxx"]</td>
</tr>
<tr>
<td style="text-align: left;">tags</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">array</td>
<td>标签,如: ["14073749806653305"]、["14073749806653305","14073749890603286"]</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
{
&quot;app_id&quot;:&quot;xxx&quot;,
&quot;access_token&quot;:&quot;xxx&quot;,
&quot;corp_id&quot;:&quot;xxxx&quot;,
&quot;group_id&quot;:&quot;xxxx&quot;,
&quot;data&quot;: [&quot;130xxxxxxxx&quot;],
&quot;tags&quot;: [“14073749806653305”],
}
</code></pre>
<h5>响应示例</h5>
<pre><code>HTTP/1.1 200 OK
{
&quot;task_id&quot;:1,
&quot;errcode&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>