Dokumentacja API proxy

REST API umożliwia Twojemu kodowi sprawdzanie cen, odczyt salda kredytu i pozostałych GB, zakup ruchu oraz pobranie danych logowania do proxy. JSON przez HTTPS, jeden klucz Bearer na konto, tworzony na stronie kluczy API w konsoli.

Podstawowy URLhttps://gbproxies.cc/api/v1

AutoryzacjaAuthorization: Bearer gbk_...

Limit300 żądań na minutę na klucz

Endpointy

GET /productsKlucz: NieProdukty, ceny za GB z krokami objętościowymi, porty i opcje targetowania.

GET /locations?product=residentialKlucz: NieKraje i unikalne IP widziane w ciągu 30 dni dla jednego produktu.

GET /balanceKlucz: TakTwój kredyt w USD oraz GB kupione, użyte i pozostałe dla każdego produktu.

GET /proxyKlucz: TakHost bramy, Twoja nazwa użytkownika i hasło proxy oraz porty każdego produktu.

POST /ordersKlucz: TakKup ruch: JSON body {"product": "residential", "gb": 50}. Płatne z kredytu.

GET /ordersKlucz: TakTwoje ostatnie 50 zakupów.

Przykłady

Odpowiedź na zakup zawiera ID zamówienia, dodane GB i cenę. Dane logowania do proxy odczytaj raz za pomocą GET /proxy i używaj ich ponownie; nie zmieniają się między zakupami.

{
  "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/orders

import 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());

Błędy

Każda odpowiedź zawiera pole ok. Błędy dodają error (stabilny kod) i message. Żadne błędy nie powodują obciążenia.

unauthorized401Brakujący lub błędny klucz API.

bad_product400Nieznane id produktu.

bad_gb400GB poza minimum i maksimum produktu.

funds402Niewystarczający kredyt. need_usd wskazuje, ile należy dodać. Nic nie jest pobierane.

network503Nie można dodać ruchu w tej chwili. Nic nie zostało obciążone; spróbuj ponownie później.

rate_limited429Więcej niż 300 żądań na minutę na jeden klucz.

Przewodniki integracji proxy