IP提取接口文档(按次提取或包时套餐)
<h5>简要描述</h5>
<ul>
<li>获取IP接口(注:必须先实名后才能使用)</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>https://sch.shanchendaili.com/api.html</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET </li>
</ul>
<h5>请求示例</h5>
<p><a href="https://sch.shanchendaili.com/api.html?action=get_ip&key={密钥}&time=10&count=1&type=json&only=0">https://sch.shanchendaili.com/api.html?action=get_ip&key={密钥}&time=10&count=1&type=json&only=0</a></p>
<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;">action</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>action</td>
</tr>
<tr>
<td style="text-align: left;">key</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>key</td>
</tr>
<tr>
<td style="text-align: left;">time</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>时长(10分钟,5分钟,3分钟,1分钟,不填写默为1分钟)</td>
</tr>
<tr>
<td style="text-align: left;">count</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>数量(最小值1,最大值200,不填写默为1)</td>
</tr>
<tr>
<td style="text-align: left;">only</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>是否去重,默认不去重(1=是;0=否)</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>数据格式(json/text,默认json)</td>
</tr>
<tr>
<td style="text-align: left;">textSep</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>text数据格式的分隔符(默认\r\n 1:\r\n, 2:\r, 3:\n, 4:\t)</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>省份编号</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>城市编号</td>
</tr>
</tbody>
</table>
<h5>json格式返回示例</h5>
<pre><code>{
&quot;count&quot;: &quot;2&quot;,
&quot;status&quot;: &quot;0&quot;,
&quot;expire&quot;: &quot;2024-11-13 11:11:40&quot;,
&quot;list&quot;: [
{
&quot;sever&quot;: &quot;114.99.227.81&quot;,
&quot;port&quot;: 30006,
&quot;net_type&quot;: 1
},
{
&quot;sever&quot;: &quot;182.111.75.21&quot;,
&quot;port&quot;: 35050,
&quot;net_type&quot;: 1
}
]
}</code></pre>
<h5>返回参数说明</h5>
<h5>text格式返回示例</h5>
<pre><code>&quot;222.184.164.53:40074\r\n&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;">count</td>
<td style="text-align: left;">string</td>
<td>返回IP数量</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">string</td>
<td>返回状态,0表示成功,其他值表示错误</td>
</tr>
<tr>
<td style="text-align: left;">info</td>
<td style="text-align: left;">string</td>
<td>错误信息描述</td>
</tr>
<tr>
<td style="text-align: left;">list</td>
<td style="text-align: left;">array</td>
<td>服务器列表</td>
</tr>
<tr>
<td style="text-align: left;">net_type</td>
<td style="text-align: left;">int</td>
<td>运营商类型,1:电信,2:移动,3:联通,4:未知</td>
</tr>
</tbody>
</table>
<h5>json格式返回失败示例</h5>
<pre><code>{
&quot;status&quot;: &quot;-12&quot;,
&quot;info&quot;: &quot;key值有误&quot;
}
{
&quot;status&quot;: &quot;-13&quot;,
&quot;info&quot;: &quot;ip未在白名单中&quot;
}
{
&quot;status&quot;: &quot;-14&quot;,
&quot;info&quot;: &quot;您的余额不足&quot;
}</code></pre>
<h5>text格式返回失败示例</h5>
<pre><code>&quot;error000x-12&quot;
&quot;error000x-13&quot;
&quot;error000x-14&quot;</code></pre>
<h5>接口响应错误定义</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">错误代码</th>
<th style="text-align: left;">错误定义</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">-2</td>
<td style="text-align: left;">从远程服务器获取IP失败,资源不足</td>
</tr>
<tr>
<td style="text-align: left;">-4</td>
<td style="text-align: left;">连接不上资源服务器</td>
</tr>
<tr>
<td style="text-align: left;">-8</td>
<td style="text-align: left;">分钟数有误</td>
</tr>
<tr>
<td style="text-align: left;">-12</td>
<td style="text-align: left;">key值有误</td>
</tr>
<tr>
<td style="text-align: left;">-13</td>
<td style="text-align: left;">ip未在白名单中</td>
</tr>
<tr>
<td style="text-align: left;">-14</td>
<td style="text-align: left;">您的余额不足</td>
</tr>
<tr>
<td style="text-align: left;">-15</td>
<td style="text-align: left;">账号已冻结,请联系客服</td>
</tr>
<tr>
<td style="text-align: left;">-16</td>
<td style="text-align: left;">提取数量有误</td>
</tr>
<tr>
<td style="text-align: left;">-17</td>
<td style="text-align: left;">ip提取失败</td>
</tr>
<tr>
<td style="text-align: left;">-18</td>
<td style="text-align: left;">请先实名</td>
</tr>
<tr>
<td style="text-align: left;">-19</td>
<td style="text-align: left;">textSep值有误</td>
</tr>
<tr>
<td style="text-align: left;">-20</td>
<td style="text-align: left;">每秒提取IP的次数超过可用次数</td>
</tr>
<tr>
<td style="text-align: left;">-23</td>
<td style="text-align: left;">省份或城市编号错误</td>
</tr>
</tbody>
</table>