Документация по прокси 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 сохраняется в течение времени, указанного в ttl (1-1,440 минут). Чтобы получить новый 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.

• Базовый адрес: 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 вызовов в минуту. Для периодической проверки баланса или трафика достаточно 1 запроса в минуту.

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