使用白名单 IP 的请求

了解在将 IP 列入白名单后如何使用住宅代理发起请求。

使用白名单 IP，您可以访问 Oxylabs 的住宅代理 而无需提供 用户名 和 密码。将您的 IP 地址加入白名单后，您可以指定所有代理参数 直接在子域名中。

如果您将某个 IP 加入白名单，连接时应使用 白名单 IP 或凭据二选一，不要同时使用，否则可能导致意外行为。

代码示例

以下是一个示例代码，使用给定的会话 ID 目标指向纽约市：

curl -x https://cc-us-city-new_york-sessid-test123.bc.pr.oxylabs.io:7777 https://ip.oxylabs.io/location

<?php
$session_id = 'test123';  // 您的会话 ID
$city = 'new_york';  // 您想要定位的城市
$proxy = "cc-us-city-$city-sessid-$session_id.bc.pr.oxylabs.io:7777";
$query = curl_init('https://ip.oxylabs.io/location');

curl_setopt($query, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($query, CURLOPT_PROXY, "http://$proxy");
$output = curl_exec($query);
curl_close($query);

if ($output)
    echo $output;
?>

import urllib.request

session_id = 'test123'  # 您的会话 ID
city = 'new_york'  # 您想要定位的城市
proxy = 'cc-us-city-%s-sessid-%s.bc.pr.oxylabs.io:7777' % (city, session_id)

query = urllib.request.ProxyHandler({
    'http': proxy,
    'https': proxy,
})

execute = urllib.request.build_opener(query)
print(execute.open('https://ip.oxylabs.io/location').read())

package example;

import org.apache.http.HttpHost;
import org.apache.http.client.fluent.*;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpHost entry = new HttpHost("cc-us-city-new_york-sessid-test123.bc.pr.oxylabs.io", 7777);

        String query = Executor.newInstance()
            .execute(Request.Get("http://ip.oxylabs.io/location").viaProxy(entry))
            .returnContent().asString();
        
        System.out.println(query);
    }
}

using System;
using System.Net;

class Example
{
    static void Main()
    {
        var client = new WebClient();
        
        client.Proxy = new WebProxy("cc-us-city-new_york-sessid-test123.bc.pr.oxylabs.io:7777");

        Console.WriteLine(client.DownloadString("https://ip.oxylabs.io/location"));
    }
}

package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
	"net/url"
)

func main() {
	proxyURL, _ := url.Parse("https://cc-us-city-new_york-sessid-test123.bc.pr.oxylabs.io:7777")
	client := &http.Client{Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)}}

	resp, err := client.Get("https://ip.oxylabs.io/location")
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	defer resp.Body.Close()

	body, _ := ioutil.ReadAll(resp.Body)
	fmt.Println(string(body))
}

查询参数

参数

说明

cc

不区分大小写的国家代码（2 个字母）， 3166-1 alpha-2 格式。例如， DE 代表德国， GB 代表英国， TH 代表泰国。有关如何使用特定国家代理的更多详情请见此处.

city

不区分大小写的英文城市名。此参数必须搭配 cc 使用以获得更高准确性，例如： cc-GB-city-london 代表英国伦敦； cc-DE-city-berlin 代表德国柏林。对于包含两个以上单词的城市名，请将空格替换为 _，例如： city-st_petersburg 或 city-rio_de_janeiro。点击此处了解有关城市级定向的更多信息。

st

不区分大小写的美国州名称，前缀为 us_，例如： us_california, us_illinois. 点此了解有关州级定向的更多信息。

cn

若要从七大洲中的任意一个获取代理，请在授权字符串中添加 cn- 参数及两位字母代码。点击此处了解有关洲级定向的更多信息

postalcode

若要使用 ZIP 码连接代理，请添加并指定 postalcode 参数，使用 五位数 ZIP 码。此参数必须与国家代码参数配合使用 cc 以及一个不区分大小写的 2 个字母国家代码。 3166-1 alpha-2 格式. 在此了解更多。

ASN

您可以选择特定运营商的代理。您需要在请求中输入所需的 ASN 编号。在此了解更多.

sessid

会话 ID，用于在后续请求中保持相同 IP。会话在 10 分钟后过期。之后会为该会话 ID 分配新的 IP 地址。支持随机字符串、0-9 和 A-Z 字符。

sesstime

会话时长参数，用于在一定时间内保持相同 IP。最大会话时长为 30 分钟。

最后更新于1年前

这有帮助吗？

晚安

代码示例