Перейти до основного вмісту

Вступ

ADSL HTTP Proxy — це сервіс мережевого проксі, який надає Ace Data Cloud для отримання динамічних ADSL проксі IP. Через уніфікований API Ace Data Cloud ви можете швидко інтегрувати ADSL HTTP Proxy за допомогою JavaScript, реалізуючи функції HTTP/SOCKS проксі, мультиоператорність, мультипровінційність, налаштування тривалості, білий список IP тощо.

Передумови

  • Наявність облікового запису Ace Data Cloud та отримання API Token
  • Node.js 18+ або сучасне браузерне середовище

Базове використання

Основна кінцева точка виклику API ADSL HTTP Proxy:
POST https://api.acedata.cloud/adsl/extract
Повний приклад коду на JavaScript:
const response = await fetch("https://api.acedata.cloud/adsl/extract", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "number": 5,
  "type": "http",
  "duration": 300,
  "province": "广东",
  "isp": "电信"
}),
});

const result = await response.json();
console.log(result);
Будь ласка, замініть YOUR_API_TOKEN на фактичний токен, отриманий на платформі Ace Data Cloud.

Обробка відповіді

Рекомендується перевіряти статус відповіді та обробляти помилки:
if (response.ok) {
  const result = await response.json();
  console.log("Виклик успішний:", result);
} else {
  console.error(`Виклик не вдався, статус: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

Обгортка для Node.js

Рекомендується створити багаторазову функцію:
async function callADSLHTTPProxy(data) {
  const response = await fetch("https://api.acedata.cloud/adsl/extract", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API error: ${response.status}`);
  return response.json();
}

Обробка помилок

Поширені коди помилок:
Код статусуОпис
401Помилка аутентифікації, перевірте API Token
403Недостатньо коштів або відсутній доступ
429Перевищено ліміт частоти запитів
500Внутрішня помилка сервера

Наступні кроки