У цьому посібнику показано, як створити гео-таргетований 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": []
}