Примеры

Полные сценарии использования API.

Python (requests)

import requests

BASE = "https://api.wisderfin.ru"
TOKEN = "tok_abc123.ваш_секрет"
HEADERS = {"Authorization": f"Bearer {TOKEN}"}


# 1. Проверка баланса
r = requests.get(f"{BASE}/me", headers=HEADERS)
r.raise_for_status()
balance = r.json()["balance"]
print(f"Баланс: {balance} ₽")


# 2. Список доступных стран для IPv6
r = requests.get(f"{BASE}/countries", headers=HEADERS, params={"version": "6"})
r.raise_for_status()
countries = r.json()
print(f"Доступные страны: {', '.join(countries)}")


# 3. Наличие в конкретной стране
r = requests.get(f"{BASE}/countries/ru/count", headers=HEADERS, params={"version": "6"})
r.raise_for_status()
print(f"Доступно в RU: {r.json()['available']}")


# 4. Расчёт стоимости
r = requests.get(f"{BASE}/price", headers=HEADERS, params={
    "count": 2,
    "period": 30,
    "version": "6",
})
r.raise_for_status()
quote = r.json()
print(f"Стоимость: {quote['price_final']} ₽ ({quote['price_single']} ₽ за шт.)")


# 5. Покупка прокси
r = requests.post(f"{BASE}/proxies/buy", headers=HEADERS, json={
    "country": "ru",
    "period": 30,
    "count": 2,
    "version": "6",
    "proxy_type": "http",
})
r.raise_for_status()
data = r.json()
print(f"Заказ #{data['order_id']}, списано: {data['price_charged']} ₽")
for proxy in data["proxies"]:
    print(f"  {proxy['host']}:{proxy['port']}:{proxy['login']}:{proxy['password']}")


# 6. Список всех прокси
r = requests.get(f"{BASE}/proxies", headers=HEADERS)
r.raise_for_status()
proxies = r.json()
print(f"Всего прокси: {len(proxies)}")


# 7. Пинг прокси
proxy_id = proxies[0]["id"]
r = requests.get(f"{BASE}/proxies/{proxy_id}/ping", headers=HEADERS)
r.raise_for_status()
latency = r.json()["latency_ms"]
print(f"Пинг: {latency} мс" if latency else "Пинг: недоступен")


# 8. Продление прокси
r = requests.post(f"{BASE}/proxies/{proxy_id}/prolong", headers=HEADERS, json={
    "period": 30,
})
r.raise_for_status()
result = r.json()
print(f"Продлено, списано: {result['price_charged']} ₽")


# 9. Экспорт прокси в файл
r = requests.get(f"{BASE}/proxies/export", headers=HEADERS, params={
    "format": "txt",
    "proxy_type": "http",
    "active_only": "true",
})
r.raise_for_status()
with open("proxies.txt", "w") as f:
    f.write(r.text)
print("Прокси сохранены в proxies.txt")

curl

Проверка баланса

curl https://api.wisderfin.ru/me \
  -H "Authorization: Bearer tok_abc123.ваш_секрет"

Список стран

curl "https://api.wisderfin.ru/countries?version=6" \
  -H "Authorization: Bearer tok_abc123.ваш_секрет"

Расчёт стоимости

curl "https://api.wisderfin.ru/price?count=2&period=30&version=6" \
  -H "Authorization: Bearer tok_abc123.ваш_секрет"

Покупка прокси

curl -X POST https://api.wisderfin.ru/proxies/buy \
  -H "Authorization: Bearer tok_abc123.ваш_секрет" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "ru",
    "period": 30,
    "count": 2,
    "version": "6",
    "proxy_type": "http"
  }'

Список прокси

curl https://api.wisderfin.ru/proxies \
  -H "Authorization: Bearer tok_abc123.ваш_секрет"

Экспорт в TXT

curl "https://api.wisderfin.ru/proxies/export?format=txt&active_only=true" \
  -H "Authorization: Bearer tok_abc123.ваш_секрет" \
  -o proxies.txt

Продление прокси

curl -X POST https://api.wisderfin.ru/proxies/12345/prolong \
  -H "Authorization: Bearer tok_abc123.ваш_секрет" \
  -H "Content-Type: application/json" \
  -d '{"period": 30}'

Пинг прокси

curl https://api.wisderfin.ru/proxies/12345/ping \
  -H "Authorization: Bearer tok_abc123.ваш_секрет"