取号
<h5>功能描述</h5>
<ul>
<li>
<p>取手机号</p>
</li>
<li><code>使用项目ID进行取号则取的平台卡，使用专属对接码取号则取的是该专属中的手机号</code>
<h5>请求URL</h5></li>
<li><code>http://api.weilai.best/getphone</code>
<h5>请求示例</h5>
<p>平台卡</p></li>
<li><code>http://api.weilai.best/getphone?token=返回token&id=10001</code>
指定专属卡（可不加入对接）</li>
<li><code>http://api.weilai.best/getphone?token=返回token&id=10001-GBERCD</code>
所有专属卡(所有已加入对接)</li>
<li><code>http://api.weilai.best/getphone?token=返回token&id=10001-all</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;">id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>例如传入：10001=平台卡，10001-abcdfe=指定专属，10001-all=全部加入专属</td>
</tr>
<tr>
<td style="text-align: left;">operator</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>运营商 不填或0=不限 1为实卡 2为虚拟</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>指定号码或号段，传入完整手机号即为指定取号，传入开头前几位即为指定号段</td>
</tr>
<tr>
<td style="text-align: left;">blackphone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>排除号段，例如162，目前只支持排除一个号段</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>筛选归属地，具体到省，可传入各省名字进行筛选，参考客户端省份名</td>
</tr>
<tr>
<td style="text-align: left;">rd</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>开发者用户名，用来赚取平台分成</td>
</tr>
<tr>
<td style="text-align: left;">addblack</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Boolean</td>
<td>是否拉黑，传入true则拉黑取到的号码，后续无需再次拉黑，使用完成无需操作，不能使用释放处理即可</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
"code": "ok",
"requestid": "1",
"phone": "12345678910"
"residual": "149"
}</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;">code</td>
<td style="text-align: left;">string</td>
<td>状态代码，ok代表成功，eroor代表错误</td>
</tr>
<tr>
<td style="text-align: left;">requestid</td>
<td style="text-align: left;">string</td>
<td>请求id，利用此id可对返回手机号进行取码、释放、拉黑、发送短信等操作</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">string</td>
<td>返回手机号</td>
</tr>
<tr>
<td style="text-align: left;">residual</td>
<td style="text-align: left;">string</td>
<td>1分钟内剩余取号数,到0时必须停止，否则封禁账号不处理</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误信息请参考msg信息</li>
</ul>