В этом руководстве показано, как создать гео-таргетированный residential-лист с ротацией.
Каждый запрос использует ваш персональный API-ключ из личного кабинета (как получить API-ключ). В примерах ниже замените YOUR_API_KEY на свой ключ. Чтобы оплатить с баланса аккаунта, используйте paymentId = 1.
Шаг 1 — Проверьте пакет
Убедитесь, что residential-пакет активен и есть трафик. Скопируйте package_key.
Эндпоинт
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
Ответ
{
"status": "success",
"data": {
"rotation": 60,
"traffic_limit": "7516192768",
"traffic_usage": "10",
"traffic_left": "10",
"package_key": "1234567890abcdefedcb",
"expired_at": "d.m.Y",
"is_active": true,
"tarif_id": 2
},
"errors": []
}
Шаг 2 — Получите доступные локации
Скачайте доступные локации (страна / регион / город / ISP), чтобы знать точные значения GEO. Ответ — JSON/ZIP с полным деревом GEO.
Эндпоинт
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/geo
Ответ
[
{
"code": "US",
"name": "United States",
"regions": [
{ "name": "Washington", "cities": [ { "name": "Garfield", "isps": [ "FIRST-STEP" ] } ] }
]
}
]
Шаг 3 — Создайте лист
Создайте лист, указав название, объект geo (из шага 2), настройки export и значение ротации.
Эндпоинт
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Тело запроса
Имя | Тип | Описание |
title | String | Название листа. |
whitelist (необязательный) | String | IP для авторизации. Оставьте пустым для авторизации по логину:паролю. |
geo | object | Объект с |
export | object | Объект: |
rotation | Number | Ротация: |
Пример
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Ответ
{
"status": "success",
"data": {
"id": 561,
"title": "US Washington Garfield FIRST-STEP",
"login": "3c8aa1d4",
"password": "AZT62Dx3",
"geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
"export": { "ports": 10000, "ext": "txt" }
},
"errors": []
}
Шаг 4 — Проверьте созданный лист
Получите список residential-листов, чтобы убедиться в создании и взять данные подключения.
Эндпоинт
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists
Ответ
{
"status": "success",
"data": [
{ "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
],
"errors": []
}