Ротационные учетные данные прокси

Генерация учетных данных для ротационных резидентных прокси с настраиваемыми типами сессий и географическим таргетингом.

Генерация ротационных учетных данных

Создайте учетные данные для ротационных прокси с определенными параметрами.

Endpoint

POST /proxies/rotating-credentials/

Предварительные требования

Сначала получите данные подключения из заказанного ротационного прокси:

curl -X 'GET' \
  'https://app.cyberyozh.com/api/v1/proxies/history/?category=residential_rotating&expired=false' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ'

Вам понадобятся:

• connection_login
• connection_password
• connection_host
• connection_port

Запрос

curl -X 'POST' \
  'https://app.cyberyozh.com/api/v1/proxies/rotating-credentials/' \
  -H 'accept: application/json' \
  -H 'X-Api-Key: ваш_api_ключ' \
  -H 'Content-Type: application/json' \
  -d '{
    "connection_login": "ваш_логин",
    "connection_password": "ваш_пароль",
    "connection_host": "proxy.example.com",
    "connection_port": 8080,
    "session_type": "short_session",
    "country_code": "us",
    "region": "california",
    "city": "los angeles",
    "amount": 5
  }'

Поля запроса

Поле	Тип	Обязательно	Описание
connection_login	string	Да	Логин из заказанного прокси
connection_password	string	Да	Пароль из заказанного прокси
connection_host	string	Да	Хост из заказанного прокси
connection_port	integer	Да	Порт из заказанного прокси
session_type	string	Да	Тип ротации IP (см. ниже)
country_code	string	Нет	Код целевой страны
region	string	Нет	Целевой регион
city	string	Нет	Целевой город
amount	integer	Нет	Количество учетных данных (только для short_session)

Типы сессий

Тип	Описание
random	IP меняется при каждом запросе/обновлении
short_session	Один IP сохраняется ~1 минуту
long_session	Один IP сохраняется ~4 часа

Ответ

{
  "credentials": [
    "login-session_params:password@host:port",
    "login-session_params:password@host:port"
  ]
}

Учетные данные имеют формат:

<connection_login>-<параметры_сессии>:<connection_password>@<connection_host>:<connection_port>

Географический таргетинг

Для поддерживаемых стран, регионов и городов обратитесь к JSON файлу ротационных стран:

Скачать rotating_countries.json

Пример использования

import requests

# Генерация учетных данных
credentials_response = requests.post(
    'https://app.cyberyozh.com/api/v1/proxies/rotating-credentials/',
    headers={'X-Api-Key': 'ваш_api_ключ'},
    json={
        'connection_login': 'ваш_логин',
        'connection_password': 'ваш_пароль',
        'connection_host': 'proxy.example.com',
        'connection_port': 8080,
        'session_type': 'short_session',
        'country_code': 'us',
        'amount': 3
    }
)

creds = credentials_response.json()['credentials']

# Использование первых учетных данных
proxy = {
    'http': f'http://{creds[0]}',
    'https': f'http://{creds[0]}'
}

response = requests.get('https://api.ipify.org', proxies=proxy)
print(f"Ваш IP: {response.text}")

Примечания

• Параметр amount работает только с типом short_session
• Опции географического таргетинга зависят от покрытия провайдера прокси
• Учетные данные генерируются динамически и могут быть регенерированы по необходимости