İçeriğe geç
hiproxy
Başlayın

HiProxy API rehberi

Panelde yaptıklarınızı kendi kodunuzdan da yapabilirsiniz. Bakiyenizi ve bağlantı bilgilerinizi okuyun, fiyatları kontrol edin, bakiyenizden sipariş verin ve seçeneklerle proxy kullanıcı adları oluşturun, hepsi bir REST API üzerinden.

API anahtarı alınUç noktaları görüntüle

Nasıl başlarım?

  1. 1Bir kullanıcı adıyla kayıt olun ve panele giriş yapın.
  2. 2Bağlantı sekmesinden bir API anahtarı oluşturun. Anahtarın tamamı yalnızca bir kez gösterilir, bu yüzden hemen güvenli bir yere kaydedin.
  3. 3Anahtarı, gerektiren her isteğin Authorization başlığına koyun.
  4. 4Anahtarın çalıştığını doğrulamak için önce /account çağırın, ardından /orders ile sipariş verin.

Kimlik doğrulama nasıl çalışır?

Kendi hesabınızla ilgili istekler (account, orders, proxy-user) API anahtarı gerektirir. Anahtarı başlıkta Authorization: Bearer hpk_... olarak gönderin. Fiyatlar, ülkeler ve fiyat teklifleri herkese açıktır, anahtar gerekmez.

HiProxy anahtarınızın kendisini değil, yalnızca hash değerini saklar. Kaybederseniz panelden yenisini oluşturun, eski anahtar o anda engellenir. Anahtarı yalnızca sunucu tarafı kodda tutun, tarayıcıda çalışan kodda veya herkese açık bir depoda asla bulundurmayın.

HTTP header
Authorization: Bearer hpk_your_api_key

Temel URL ve veri biçimi

Temel URL
https://hiproxy.shop/api/v1
İstek ve yanıt gövdesi
application/json
Tutarlar
Sayı olarak USD, örn. 1036.60
Zaman damgaları
ISO 8601 (UTC)

İstek sınırı var mı?

Her API anahtarı dakikada en fazla 60 çağrı yapabilir. Anahtarsız çağrılan herkese açık uç noktalar IP başına dakikada 60 çağrıya izin verir. Sınırı aşarsanız HTTP 429 alırsınız. Bir dakika bekleyin, sonra tekrar gönderin.

Hata yanıtı nasıl görünür?

Bir HTTP durum kodu ve kısa bir hata kodu ile mesaj içeren bir JSON gövdesi alırsınız.

Örnek
{
  "error": {
    "code": "insufficient_balance",
    "message": "Your balance is too low for this order. Top up in the dashboard."
  }
}
code
bad_requestHTTP 400Gerekli bir değer eksik ya da bu ürün bu değeri kabul etmiyor.
unauthorizedHTTP 401API anahtarı gönderilmedi veya anahtar yanlış.
insufficient_balanceHTTP 402Bakiyeniz sipariş tutarından düşük. Bakiyenize dokunulmadı.
not_foundHTTP 404Hesabınızda bu kimliğe sahip bir sipariş yok.
rate_limitedHTTP 429Dakika başına istek sınırını aştınız.
server_errorHTTP 500Sunucu isteği tamamlayamadı. Bakiyenize dokunulmadı.

Uç noktalar

Hesabınızı okuyun

GET/api/v1/accountAPI anahtarı gerekir

Bakiyenizi, proxy host ve portlarını, proxy kullanıcı adı ve şifresini ve İzinli IP'ler listesini gösterir.

İstek
curl https://hiproxy.shop/api/v1/account \
  -H "Authorization: Bearer hpk_your_api_key"
Yanıt
{
  "username": "hi_user01",
  "balance_usd": 1300,
  "proxy": {
    "host": "gate.hiproxy.shop",
    "http_port": 6100,
    "socks5_port": 6200,
    "username": "hpexample1",
    "password": "your_password"
  },
  "allowed_ips": [
    "203.0.113.10"
  ]
}

Ürünleri ve fiyatları okuyun

GET/api/v1/productsAnahtarsız

Her ürünün sipariş sınırlarını, kademe başına fiyatını ve süre indirimlerini gösterir. Fiyatlar sayfasıyla aynı fiyat tablosunu kullanır.

İstek
curl https://hiproxy.shop/api/v1/products
Yanıt
{
  "currency": "USD",
  "prices_as_of": "2026-10-31",
  "products": [
    {
      "id": "unlimited",
      "unit": "day",
      "quantity": {
        "meaning": "days",
        "min": 1,
        "max": 365
      },
      "...": "..."
    },
    {
      "id": "residential",
      "unit": "gb",
      "...": "..."
    }
  ]
}

Ülkeleri ve şehirleri listele

GET/api/v1/countriesAnahtarsız

Her ürünün desteklediği ülkeleri ve -city- kullanıcı adı seçeneğinde kullanılacak şehir değerlerini gösterir.

AlanAnlamı
productİsteğe bağlıunlimited, residential, isp, datacenter değerlerinden biri. Boş bırakılırsa residential.
İstek
curl "https://hiproxy.shop/api/v1/countries?product=datacenter"
Yanıt
{
  "product": "datacenter",
  "countries": [
    {
      "code": "us",
      "name": "United States",
      "region": "americas",
      "datacenter": true,
      "cities": [
        {
          "name": "New York",
          "value": "new_york"
        },
        {
          "name": "Los Angeles",
          "value": "los_angeles"
        }
      ]
    }
  ]
}

Fiyat teklifi alın

POST/api/v1/quoteAnahtarsız

Bakiyenize dokunmadan sipariş toplamını hesaplar. Sipariş verirken göndereceğiniz gövdenin aynısını gönderin.

AlanAnlamı
productZorunluunlimited, residential, isp, datacenter değerlerinden biri.
quantityZorunluunlimited için gün (1~365), residential için GB (5~5,000), isp (1~1,000) veya datacenter (5~5,000) için IP sayısı.
concurrencyİsteğe bağlıYalnızca unlimited. 200, 500, 1000 veya 2000 seçin.
bandwidthİsteğe bağlıYalnızca unlimited, Mbps cinsinden. 100, 200, 500 veya 1000 seçin.
monthsİsteğe bağlıYalnızca isp ve datacenter. 1, 3, 6 veya 12 seçin.
countryİsteğe bağlıYalnızca isp ve datacenter. jp gibi iki harfli ülke kodu. Geçerli değerler /countries içinde listelenir.
İstek
curl -X POST https://hiproxy.shop/api/v1/quote \
  -H "Content-Type: application/json" \
  -d '{"product":"unlimited","quantity":30,"concurrency":1000,"bandwidth":200}'
Yanıt
{
  "product": "unlimited",
  "quantity": 30,
  "unit_price_usd": 8.78,
  "unit": "day",
  "total_usd": 263.4
}

Sipariş verin

POST/api/v1/ordersAPI anahtarı gerekir

Toplam tutarı bakiyenizden düşer ve siparişi oluşturur. Sipariş pending (etkinleştiriliyor) olarak başlar ve hazır olunca active olur. Etkinleştirilemeyen sipariş refunded olur ve ödediğiniz her şey bakiyenize döner. Bakiyeniz yetersizse 402 alırsınız.

AlanAnlamı
productZorunluunlimited, residential, isp, datacenter değerlerinden biri.
quantityZorunluunlimited için gün (1~365), residential için GB (5~5,000), isp (1~1,000) veya datacenter (5~5,000) için IP sayısı.
concurrencyİsteğe bağlıYalnızca unlimited. 200, 500, 1000 veya 2000 seçin.
bandwidthİsteğe bağlıYalnızca unlimited, Mbps cinsinden. 100, 200, 500 veya 1000 seçin.
monthsİsteğe bağlıYalnızca isp ve datacenter. 1, 3, 6 veya 12 seçin.
countryİsteğe bağlıYalnızca isp ve datacenter. jp gibi iki harfli ülke kodu. Geçerli değerler /countries içinde listelenir.
İstek
curl -X POST https://hiproxy.shop/api/v1/orders \
  -H "Authorization: Bearer hpk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"product":"unlimited","quantity":30,"concurrency":1000,"bandwidth":200}'
Yanıt
{
  "order": {
    "id": "HP-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.78,
    "total_usd": 263.4,
    "status": "pending",
    "created_at": "2026-10-31T09:12:44.120Z",
    "updated_at": "2026-10-31T09:12:44.120Z"
  },
  "balance_usd": 1036.6
}

Siparişleri listele

GET/api/v1/ordersAPI anahtarı gerekir

Siparişlerinizden en fazla 100 tanesini en yeniden başlayarak gösterir.

AlanAnlamı
statusİsteğe bağlıpending, active, refunded değerlerinden biri. Boş bırakılırsa her durumdaki siparişler döner.
İstek
curl "https://hiproxy.shop/api/v1/orders?status=pending" \
  -H "Authorization: Bearer hpk_your_api_key"
Yanıt
{
  "orders": [
    {
      "id": "HP-7KQ2M-X4HTD",
      "product": "unlimited",
      "quantity": 30,
      "months": null,
      "concurrency": 1000,
      "bandwidth_mbps": 200,
      "country": null,
      "unit_price_usd": 8.78,
      "total_usd": 263.4,
      "status": "pending",
      "created_at": "2026-10-31T09:12:44.120Z",
      "updated_at": "2026-10-31T09:12:44.120Z"
    }
  ]
}

Tek bir siparişi okuyun

GET/api/v1/orders/{id}API anahtarı gerekir

Tek bir siparişi kimliğiyle gösterir. Etkinleştirmenin bitip bitmediğini kontrol etmek için kullanışlıdır.

AlanAnlamı
idZorunluSipariş kimliği, örneğin HP-7KQ2M-X4HTD.
İstek
curl https://hiproxy.shop/api/v1/orders/HP-7KQ2M-X4HTD \
  -H "Authorization: Bearer hpk_your_api_key"
Yanıt
{
  "order": {
    "id": "HP-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.78,
    "total_usd": 263.4,
    "status": "active",
    "created_at": "2026-10-31T09:12:44.120Z",
    "updated_at": "2026-10-31T09:40:02.511Z"
  }
}

Proxy kullanıcı adı oluşturun

GET/api/v1/proxy-userAPI anahtarı gerekir

Seçeneklerinizi içeren bir proxy kullanıcı adı ile doğrudan yapıştırabileceğiniz HTTP ve SOCKS5 URL'leri verir. session olmadan IP her istekte değişir.

AlanAnlamı
productİsteğe bağlıunlimited, residential, isp, datacenter değerlerinden biri. Boş bırakılırsa unlimited.
countryİsteğe bağlıİki harfli ülke kodu, örneğin jp.
cityİsteğe bağlı/countries içinden tokyo gibi bir şehir değeri. Yalnızca country ile birlikte çalışır.
sessionİsteğe bağlı1~32 harf veya rakam. Aynı session değerine sahip istekler aynı IP'yi kullanır.
ttlİsteğe bağlıOturum IP'sinin kaç dakika korunacağı, 1~60. Boş bırakılırsa 30.
İstek
curl "https://hiproxy.shop/api/v1/proxy-user?product=residential&country=jp&city=tokyo&session=job42&ttl=30" \
  -H "Authorization: Bearer hpk_your_api_key"
Yanıt
{
  "username": "hpexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30",
  "password": "your_password",
  "http": "http://hpexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.hiproxy.shop:6100",
  "socks5": "socks5h://hpexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.hiproxy.shop:6200"
}

Adım adım örnek

Fiyatı kontrol eden, bakiyenizden sipariş veren ve bir Japonya IP'si üzerinden bağlanan tek bir script.

Python (requests)
import requests

API = "https://hiproxy.shop/api/v1"
HEAD = {"Authorization": "Bearer hpk_your_api_key"}

# 1) Check the price first
plan = {"product": "residential", "quantity": 100}
print(requests.post(f"{API}/quote", json=plan).json())

# 2) Order from your balance
r = requests.post(f"{API}/orders", json=plan, headers=HEAD)
order = r.json()["order"]
print(order["id"], order["status"])

# 3) Get a username for Japanese IPs
u = requests.get(f"{API}/proxy-user", headers=HEAD,
                 params={"product": "residential", "country": "jp"}).json()
proxies = {"http": u["http"], "https": u["http"]}
print(requests.get("https://ipinfo.io/json", proxies=proxies, timeout=30).json())
Node.js 18+
const API = "https://hiproxy.shop/api/v1";
const HEAD = { Authorization: "Bearer hpk_your_api_key", "Content-Type": "application/json" };

// Check the balance
const acc = await fetch(`${API}/account`, { headers: HEAD }).then((r) => r.json());
console.log(acc.balance_usd);

// Order 7 days of unlimited
const res = await fetch(`${API}/orders`, {
  method: "POST",
  headers: HEAD,
  body: JSON.stringify({ product: "unlimited", quantity: 7, concurrency: 500, bandwidth: 100 }),
});
if (res.status === 402) console.log("Top up first");
else console.log((await res.json()).order.id);

API üzerinden verilen siparişler panel siparişleriyle aynı şekilde işlenir ve Geçmiş sekmesinde görünür. Örneklerdeki hpk_your_api_key yerine kendi API anahtarınızı yazın.

HiProxy'yi kendi kodunuzdan çağırın

Bir kullanıcı adıyla kayıt olun, panelden bir API anahtarı oluşturun, hazırsınız.

Hesap oluşturunKurulum rehberi