取号(getPhoneList)
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>取号(getPhoneList) 不能用的号码就调用拉黑接口防止下次还会继续取到，来码的系统会自动拉黑无需调用拉黑接口
<h5>请求URL</h5></li>
<li><code>http://api.tmjiame.net/api/service/getPhoneList?token=登录时返回的token令牌&amp;cateId=项目ID </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>登录时返回的token令牌</td>
</tr>
<tr>
<td style="text-align: left;">cateId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>项目ID</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;">haoduan</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>指定号段，只能是前三位，多个号段请用/隔开，例如：135/167/170 (可空)</td>
</tr>
<tr>
<td style="text-align: left;">paichu</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>排除号段，只能是前三位，多个号段请用/隔开，例如：135/167/170 (可空)</td>
</tr>
<tr>
<td style="text-align: left;">numsize</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>批量取号一次性获取多少个号[限制1-20] (可空)</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=135xxxxxxxx,必须是平台上的号码 (可空)</td>
</tr>
<tr>
<td style="text-align: left;">kid</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>传入此参数能指定取某个商户的卡。例如：kid=某某商户的uid(商户uid在用户端查看）</td>
</tr>
<tr>
<td style="text-align: left;">专属模式</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>需要就去用户端我的专属页面自己选择即可</td>
</tr>
<tr>
<td style="text-align: left;">首次模式</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>需要就就去用户端收码页面自己选择即可</td>
</tr>
</tbody>
</table>
<h5>单线程返回示例</h5>
<pre><code>{
&quot;status&quot;: 200,
&quot;msg&quot;: &quot;success&quot;,
&quot;data&quot;: {
&quot;list&quot;: &quot;16788708421&quot;,
&quot;一分钟内剩余取号数&quot;: 7,
&quot;level&quot;: 1
}
}</code></pre>
<h5>批量返回示例</h5>
<pre><code>{
&quot;status&quot;: 200,
&quot;msg&quot;: &quot;success&quot;,
&quot;data&quot;: {
&quot;list&quot;: &quot;16788708934,16788707402,16788508874,16788708554,16788707403&quot;,
&quot;一分钟内剩余取号数&quot;: 5,
&quot;level&quot;: 1
}
}</code></pre>
<h5>异常返回示例(软件请把msg打印给用户判断为什么取号失败)</h5>
<pre><code>{
&quot;status&quot;: 400,
&quot;msg&quot;: &quot;一分钟内剩余取号数为0，请10秒后再试&quot;,
&quot;data&quot;: []
}</code></pre>
<h5>返回参数说明</h5>
<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;">status</td>
<td style="text-align: left;">int</td>
<td>200成功，400失败</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">int</td>
<td>描述</td>
</tr>
<tr>
<td style="text-align: left;">list</td>
<td style="text-align: left;">int</td>
<td>号码</td>
</tr>
<tr>
<td style="text-align: left;">一分钟内剩余取号数</td>
<td style="text-align: left;">int</td>
<td>剩余取号数会自动恢复</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>取号老是取不出就试试批量取号参数（numsize）</li>
</ul>