代理列表

通过 URL 或 RESTful API 访问企业版独享数据中心代理列表。以编程方式获取包含国家和城市信息的代理 IP。

基础

您应该会从您的专属客户经理或我们的支持团队收到一个代理列表 URL，它应类似于这样：

https://proxy.oxylabs.io/key/a27c5343ce4c4637a85a9297ddf1cace

在浏览器中（或任何其他首选软件中）打开此 URL。然后系统会要求您输入登录凭据（HTTP 基本身份验证）：

完成后，您将获得一个纯文本格式的代理列表。

如果您有多个列表，并希望获取分配给您账户的所有 IP，可以使用此 URL：

https://proxy.oxylabs.io/all

您还可以在 ?showCountry 还是 ?showCity 将其添加到 URL 末尾，以获取带有对应位置的 IP。

127.0.0.1:60000
127.0.0.2:60000
127.0.0.3:60000
127.0.0.4:60000

RESTful

显示所有可用的代理列表

通过此端点，您可以检索属于您的用户的代理列表：

GET https://api.oxylabs.io/v1/代理/lists

代码示例

cURL

curl -u username:password "https://api.oxylabs.io/v1/proxies/lists"

PHP

<?php
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://api.oxylabs.io/v1/proxies/lists");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_USERPWD, 'username:password');

$result = curl_exec($curl);
?>

Python

import requests
requests.get('https://api.oxylabs.io/v1/proxies/lists', auth=('username', 'password'))

C#

using System;
using System.Net;
using System.Text;

class Example
{
    static void Main()
    {
        HttpClient client = new HttpClient();
        var byteArray = Encoding.ASCII.GetBytes("username:password");
        client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Basic", Convert.ToBase64String(byteArray));
        var task = Task.Run(async () => {
            var response = await client.GetAsync("https://api.oxylabs.io/v1/proxies/lists");
            var content = response.Content;
            var result = await content.ReadAsStringAsync();
            return result;
        }); 
        task.Wait();
    
        Console.WriteLine(task.Result);
    }
}

示例输出

[
  {
    "uuid": "123e4567-e89b-12d3-a456-426655440000",
    "key": "12345678",
    "updated_timestamp": "2016-09-28T13:03:50+0300",
    "ips_count": 2000,
    "href": "http://api.oxylabs.io/v1/proxies/lists/123e4567-e89b-12d3-a456-426655440000"
  }
]

检索特定代理列表

使用此端点，您可以获取特定的代理列表：

GET https://api.oxylabs.io/v1/代理/lists/{uuid}

请求参数

参数	描述
UUID	要检索的代理列表的 uuid

代码示例

cURL

curl -u username:password "https://api.oxylabs.io/v1/proxies/lists/{uuid}"

PHP

<?php
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "https://api.oxylabs.io/v1/proxies/lists/{uuid}");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_USERPWD, 'username:password');
?>

Python

import requests
requests.get('https://api.oxylabs.io/v1/proxies/lists/{uuid}', auth=('username', 'password'))

C#

using System;
using System.Net;
using System.Text;

class Example
{
    static void Main()
    {
        HttpClient client = new HttpClient();
        var byteArray = Encoding.ASCII.GetBytes("username:password");
        client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Basic", Convert.ToBase64String(byteArray));
        var task = Task.Run(async () => {
            var response = await client.GetAsync("https://api.oxylabs.io/v1/proxies/lists/{uuid}");
            var content = response.Content;
            var result = await content.ReadAsStringAsync();
            return result;
        }); 
        task.Wait();
    
        Console.WriteLine(task.Result);
    }
}

示例输出

[
  {
    "ip": "127.0.0.1",
    "port": "60000",
    "country": "BE",
    "city": "布鲁塞尔",
    "created_at": "2022-04-06 13:03:10"
  },
  { 
    "ip": "127.0.0.2",
    "port": "60000",
    "country": "BE",
     "city": "布鲁塞尔",
    "created_at": "2022-04-06 13:03:10"
  }
]