Документация по API прокси
REST API позволяет вашему коду проверять цены, читать ваш кредит и оставшиеся гигабайты, покупать трафик и получать данные для входа в прокси. JSON через HTTPS, один Bearer-ключ на аккаунт, создается на странице ключей API в консоли.
Базовый URL
https://gbproxies.cc/api/v1Авторизация
Authorization: Bearer gbk_...Лимит300 запросов в минуту на ключ
Эндпоинты
GET /productsКлюч: НетПродукты, цены за GB с шагами объема, порты и опции таргетинга.GET /locations?product=residentialКлюч: НетСтраны и уникальные IP за 30 дней для одного продукта.GET /balanceКлюч: ДаВаш кредит в USD и купленные, использованные и оставшиеся GB по продуктам.GET /proxyКлюч: ДаХост шлюза, имя пользователя и пароль прокси, порты каждого продукта.POST /ordersКлюч: ДаКупить трафик: JSON тело {"product": "residential", "gb": 50}. Оплата с кредита.GET /ordersКлюч: ДаВаши последние 50 покупок.Примеры
Покупка возвращает идентификатор заказа, добавленные гигабайты и цену. Получите данные для входа в прокси один раз через GET /proxy и используйте их повторно; они не меняются между покупками.
{
"ok": true,
"id": "GO-7K2MQX9PLA",
"product": "residential",
"gb": 50,
"price_usd": "30.00",
"state": "added"
}curl https://gbproxies.cc/api/v1/products
curl -H "Authorization: Bearer gbk_YOUR_KEY" https://gbproxies.cc/api/v1/balance
curl -X POST -H "Authorization: Bearer gbk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"product":"residential","gb":50}' https://gbproxies.cc/api/v1/ordersimport requests
H = {"Authorization": "Bearer gbk_YOUR_KEY"}
print(requests.get("https://gbproxies.cc/api/v1/balance", headers=H).json())
r = requests.post("https://gbproxies.cc/api/v1/orders", headers=H, json={"product": "residential", "gb": 50})
print(r.status_code, r.json())const H = { Authorization: "Bearer gbk_YOUR_KEY", "Content-Type": "application/json" };
console.log(await (await fetch("https://gbproxies.cc/api/v1/balance", { headers: H })).json());
const r = await fetch("https://gbproxies.cc/api/v1/orders", { method: "POST", headers: H, body: JSON.stringify({ product: "residential", gb: 50 }) });
console.log(r.status, await r.json());Ошибки
Каждый ответ содержит ok. Ошибки добавляют error (стабильный код) и message. Ничего не списывается при любой ошибке.
unauthorized401Отсутствует или неверный API-ключ.bad_product400Неизвестный ID продукта.bad_gb400GB вне минимального и максимального значения продукта.funds402Недостаточно кредита. need_usd показывает, сколько нужно добавить. Средства не списываются.network503Трафик не может быть добавлен прямо сейчас. Ничего не списывается; попробуйте позже.rate_limited429Более 300 запросов в минуту на один ключ.