获取手机接口(getPhone)
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>获取手机接口(getPhone)</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://api.lxy8.net/sms/api/getPhone?token=登录时返回的令牌&amp;sid=项目ID&amp;numsize=1</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET </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;">token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>登录时返回的令牌</td>
</tr>
<tr>
<td style="text-align: left;">sid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>项目ID</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>需要指定号码或者二次多次接码传入phone=18151615155,必须是平台上的号码 (可空)</td>
</tr>
<tr>
<td style="text-align: left;">ascription</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>ascription=1取随机实卡号段，ascription=2取随机虚卡号段 (可空)</td>
</tr>
<tr>
<td style="text-align: left;">kid</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>可以指定对应共享商的uid，只获取他的号码 (可空)</td>
</tr>
<tr>
<td style="text-align: left;">haoduan</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>可以指定号段，只获取对应号段的号码例如165 (可空)</td>
</tr>
<tr>
<td style="text-align: left;">numsize</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>批量取号一次性获取多少个号码[限制1-40] (可空)</td>
</tr>
<tr>
<td style="text-align: left;">paichu</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>指定排除的号段，例如165 则不会获取到165的号段 (可空)</td>
</tr>
<tr>
<td style="text-align: left;">devid</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>指定共享商的机器工作室编号，则只会获取对应机器的号码，编号需要找共享商要 (可空)</td>
</tr>
</tbody>
</table>
<h5>单线程返回示例</h5>
<pre><code>{&quot;msg&quot;:&quot;success&quot;,&quot;code&quot;:0,&quot;phone&quot;:&quot;13852137155&quot;}</code></pre>
<h5>批量获取返回示例</h5>
<pre><code>{&quot;msg&quot;:&quot;success&quot;,&quot;code&quot;:0,&quot;phone&quot;:&quot;13852137155，13852137153，13852137154&quot;}</code></pre>
<h5>异常返回示例(软件请把msg打印给用户判断为什么取号失败)</h5>
<pre><code>{&quot;msg&quot;:&quot;余额不足请充值&quot;,&quot;code&quot;:-4}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">返回code</th>
<th style="text-align: left;">描述</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">0</td>
<td style="text-align: left;">成功并返回手机信息</td>
</tr>
<tr>
<td style="text-align: left;">401</td>
<td style="text-align: left;">token失效(所有接口通用如返回请重新登录)</td>
</tr>
<tr>
<td style="text-align: left;">-1</td>
<td style="text-align: left;">暂无号码请延迟10秒后再次请求</td>
</tr>
<tr>
<td style="text-align: left;">-2</td>
<td style="text-align: left;">项目已禁用</td>
</tr>
<tr>
<td style="text-align: left;">-3</td>
<td style="text-align: left;">余额不足,请充值/金额不足</td>
</tr>
<tr>
<td style="text-align: left;">-4</td>
<td style="text-align: left;">上次获取失败,5秒后重试 (请求速度过快请间隔5秒获取一次)</td>
</tr>
<tr>
<td style="text-align: left;">-5</td>
<td style="text-align: left;">您的状态异常无法取号请联系客服</td>
</tr>
<tr>
<td style="text-align: left;">-5</td>
<td style="text-align: left;">取号频繁，请使用批量取号指定numsize参数</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>