SmartproxyAPI代理提取指南JSON-first 架构与参数化最佳实践

GET https://gw.smartproxy.cn/v1/ips?country=US&city=New%20York&type=dynamic_residential&count=5Authorization: Bearer sk_live_xxxxxxxxxxxxxX-Client-Id: your-application-id

GET https://gw.smartproxy.cn/v1/ips  ?type=dynamic_residential  &country=US  &city=New%20York  &asn=22252  &count=3  &session=sticky  &ttl=120  &purpose=data_collectionAuthorization: Bearer sk_live_xxxxxxxxxxxxxContent-Type: application/json

{  "request_id": "req_01hv1n2k3m4p5q6r",  "ips": [    {      "ip": "192.0.2.10",      "port": 443,      "country": "US",      "city": "New York",      "asn": 22252,      "type": "dynamic_residential",      "session_id": "sess_abcd1234efgh",      "ttl": 120,      "expires_at": "2025-10-23T10:45:30Z"    },    {      "ip": "198.51.100.7",      "port": 443,      "country": "US",      "city": "New York",      "asn": 22252,      "type": "dynamic_residential",      "session_id": "sess_abcd1234efgh",      "ttl": 120,      "expires_at": "2025-10-23T10:45:31Z"    }  ],  "limits": {    "rate_limit_per_min": 600,    "burst": 120  }}

{  "error": {    "status": 429,    "code": "RATE_LIMIT_EXCEEDED",    "message": "请求频率超限,请稍后重试",    "retryable": true,    "retry_after_ms": 800,    "trace_id": "trc_01hv2g7n8p9q"  }}

for attempt in range(1, 6):    response = get_ips()    if response.ok:        return response    if not response.retryable:        break    sleep(base_delay * (2 ** (attempt - 1)) * random_jitter())

curl -sS \  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" \  "https://gw.smartproxy.cn/v1/ips?type=dynamic_residential&country=US&city=New%20York&count=2&session=sticky&ttl=120"

import requestsurl = "https://gw.smartproxy.cn/v1/ips"params = {    "type": "dynamic_residential",    "country": "US",    "city": "New York",    "count": 2,    "session": "sticky",    "ttl": 120}headers = {"Authorization": "Bearer sk_live_xxxxxxxxxxxxx"}response = requests.get(url, params=params, headers=headers, timeout=15)print(response.json())

import fetch from 'node-fetch';const url = new URL('https://gw.smartproxy.cn/v1/ips');url.search = new URLSearchParams({    type: 'dynamic_residential',    country: 'US',    city: 'New York',    count: '2',    session: 'sticky',    ttl: '120'}).toString();const response = await fetch(url, {    headers: { Authorization: 'Bearer sk_live_xxxxxxxxxxxxx' }});console.log(await response.json());

package mainimport (    "fmt"    "io/ioutil"    "net/http"    "net/url"    "time")func main() {    u, _ := url.Parse("https://gw.smartproxy.cn/v1/ips")    q := u.Query()    q.Set("type", "dynamic_residential")    q.Set("country", "US")    q.Set("city", "New York")    q.Set("count", "2")    q.Set("session", "sticky")    q.Set("ttl", "120")    u.RawQuery = q.Encode()    req, _ := http.NewRequest("GET", u.String(), nil)    req.Header.Set("Authorization", "Bearer sk_live_xxxxxxxxxxxxx")    client := &http.Client{Timeout: 15 * time.Second}    resp, err := client.Do(req)    if err != nil {        panic(err)    }    defer resp.Body.Close()    body, _ := ioutil.ReadAll(resp.Body)    fmt.Println(string(body))}

import java.net.http.*;import java.net.URI;public class SmartproxyExample {    public static void main(String[] args) throws Exception {        var client = HttpClient.newHttpClient();        var uri = URI.create("https://gw.smartproxy.cn/v1/ips?type=dynamic_residential&country=US&city=New%20York&count=2&session=sticky&ttl=120");        var request = HttpRequest.newBuilder(uri)            .header("Authorization", "Bearer sk_live_xxxxxxxxxxxxx")            .GET()            .build();        var response = client.send(request, HttpResponse.BodyHandlers.ofString());        System.out.println(response.body());    }}

{  "error": {    "status": 503,    "code": "SERVICE_UNAVAILABLE",    "message": "上游服务暂时不可用",    "retryable": true,    "retry_after_ms": 1200,    "trace_id": "trc_01hv3k7m8n9p"  }}