Przejdź do głównej treści

Wprowadzenie

ADSL HTTP Proxy to usługa proxy sieciowego oferowana przez Ace Data Cloud, umożliwiająca dynamiczne pozyskiwanie adresów IP ADSL. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko zintegrować ADSL HTTP Proxy w Pythonie, realizując funkcje takie jak proxy HTTP/SOCKS, obsługa wielu operatorów, wielu prowincji, niestandardowy czas trwania oraz biała lista IP.

Wymagania wstępne

  • Konto w Ace Data Cloud oraz uzyskany token API
  • Środowisko Python 3.7 lub nowsze
  • Zainstalowana biblioteka requests: pip install requests

Podstawowe użycie

Główny endpoint API ADSL HTTP Proxy to:
POST https://api.acedata.cloud/adsl/extract
Pełny przykład kodu w Python:
import requests

url = "https://api.acedata.cloud/adsl/extract"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "number": 5,
    "type": "http",
    "duration": 300,
    "province": "广东",
    "isp": "电信"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

Obsługa odpowiedzi

Po udanym wywołaniu API zwraca dane w formacie JSON. Zaleca się sprawdzenie kodu statusu HTTP:
if response.status_code == 200:
    result = response.json()
    print("Wywołanie zakończone sukcesem:", result)
else:
    print(f"Wywołanie nie powiodło się, kod statusu: {response.status_code}")
    print(response.text)

Zaawansowane użycie

Dla API obsługujących zadania asynchroniczne można otrzymać wynik poprzez callback URL:
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Wynik zostanie przesłany do Twojego serwera za pomocą callback URL

Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Błąd uwierzytelniania, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczona częstotliwość żądań
500Błąd wewnętrzny serwera

Inne endpointy

Usługa ADSL HTTP Proxy udostępnia również następujący endpoint:
  • POST https://api.acedata.cloud/adsl/whitelist

Kolejne kroki