Документація проксі API та методи підключення

Швидкий старт з резидентськими проксі

При покупці резидентських проксі на вашому обліковому записі відображатимуться ім'я користувача та пароль проксі. Використовуйте одну адресу підключення, а країну, місто та сесію вказуйте в імені користувача. Ось команда для швидкої перевірки підключення:

• Покупка: у вашому кабінеті оберіть потрібну кількість ГБ для придбання резидентських проксі.
• Підтвердження: перевірте ім’я користувача (USERNAME) та пароль (PASSWORD) проксі на сторінці користувача.
• Підключення: надсилайте запити на адресу gw.ipkite.com через порт HTTP 7000 або SOCKS5 7100.

curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/

Формат даних для підключення проксі

Усі підключення резидентських проксі використовують однакову адресу. HTTP/HTTPS-запити відправляються на порт 7000, SOCKS5 - на порт 7100. Додавайте параметри до імені користувача через дефіс (-), використовуючи лише потрібні вам.

USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000

Приклади ротаційного проксі та фіксованої сесії

Якщо ви не додасте sess до імені користувача, проксі буде ротаційним із новою IP для кожного запиту. Якщо додати sess і ttl, ви отримаєте фіксовану сесію, де IP зберігається протягом вказаного часу (1-1440 хвилин). Щоб змінити IP, просто змініть значення sess.

curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/

Приклад таргетингу за країною та містом

Параметр cc дозволяє вибрати одну з 174 країн/регіонів, а city - звужувати до конкретного міста. Націлювання за країною/містом працює як для ротаційних, так і для фіксованих сесій.

curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/

Приклад проксі для Python requests

У Python requests вкажіть однакову адресу проксі для HTTP та HTTPS у proxies. Для SOCKS5 встановіть requests[socks] та змініть адресу на socks5h://.

import requests

proxy = "http://USERNAME-cc-us-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000"
proxies = {"http": proxy, "https": proxy}

r = requests.get("https://example.com/", proxies=proxies, timeout=30)
print(r.status_code)

Приклад проксі для Node.js

У Node.js використовуйте ProxyAgent з undici або пакет https-proxy-agent. Обидва методи потребують лише одного рядка з адресою проксі.

import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent("http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000");
const res = await fetch("https://example.com/", { dispatcher: agent });
console.log(res.status);

Аутентифікація API для розробників та базова адреса

API для розробників працює за принципом REST, і всі відповіді надаються у форматі JSON. Коли ви генеруєте ключ API в обліковому записі, ключ, що починається з ipk_live_, відображається лише один раз, тому збережіть його в безпечному місці. У всіх запитах додайте заголовок Authorization з Bearer та ключем API.

• Базовий URL: https://ipkite.com/api/v1
• Заголовок автентифікації: Authorization: Bearer <API ключ>
• Ліміт викликів: 120 разів за хвилину
• Формат відповіді: JSON, успіх містить "ok": true

curl https://ipkite.com/api/v1/balance \
  -H "Authorization: Bearer ipk_live_YOUR_API_KEY"

Кінцева точка API для розробників

{"ok":true,"balance":"25.00","currency":"USD"}

Помилки API та ліміти викликів

Якщо ключ API відсутній або невірний, ви отримаєте відповідь HTTP 401. Перевірте назву заголовка, пробіл після Bearer та повний ключ. Ліміт викликів - 120 на хвилину. Для періодичної перевірки балансу або залишку трафіку достатньо одного запиту на хвилину.

{"ok":false,"error":"unauthorized"}