Proxy API Belgeleri: Sipariş, Bakiye ve Kullanıcı Adı

Nasıl başlarım?

1Kayıt olun ve panele giriş yapın.
2Connect bölümünü açın ve bir API anahtarı oluşturun. Anahtarın tamamı yalnızca bir kez gösterilir, bu yüzden güvenli bir yere kopyalayın.
3Anahtarı gerektiren her istekte Authorization başlığında gönderin.
4Anahtarın çalıştığını kontrol etmek için /account çağırın, ardından /orders ile sipariş verin.

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

Kendi hesabınıza ait istekler (account, orders, proxy-user) API anahtarı gerektirir. Anahtarı Authorization başlığında Bearer token olarak gönderin. Fiyatlar, ülkeler ve fiyat teklifleri herkese açıktır ve anahtar gerektirmez.

Anahtarın yalnızca hash değerini saklarız. Kaybederseniz panelden yeni bir anahtar oluşturun, eski anahtar hemen çalışmayı bırakır. Anahtarı tarayıcı kodunda ve herkese açık depolarda tutmayın.

HTTP header

Authorization: Bearer rpk_your_api_key

Temel URL ve biçim

Temel URL: https://royalproxy.online/api/v1
İstek ve yanıt gövdesi: application/json
Para: USD sayılar, örneğin 807.90
Zaman: ISO 8601 (UTC)

Çağrı sınırı var mı?

Her API anahtarı dakikada en fazla 60 istek gönderebilir. Herkese açık uç noktalar IP başına dakikada 60 isteğe izin verir. Sınır aşıldığında HTTP 429 alırsınız, bir dakika bekleyip tekrar deneyin.

Hatalar nasıl görünür?

Hatalarda HTTP durum kodu ve kısa bir kod ile mesaj içeren bir JSON gövdesi döner.

Örnek

{
  "error": {
    "code": "insufficient_balance",
    "message": "Your balance is too low for this order. Top up in the dashboard."
  }
}

HTTP	code	Anlamı
400	bad_requestHTTP 400Bir değer eksik veya bu ürün için izin verilmiyor.	Bir değer eksik veya bu ürün için izin verilmiyor.
401	unauthorizedHTTP 401API anahtarı eksik veya geçersiz.	API anahtarı eksik veya geçersiz.
402	insufficient_balanceHTTP 402Bakiye sipariş toplamından düşük. Hiçbir ücret alınmadı.	Bakiye sipariş toplamından düşük. Hiçbir ücret alınmadı.
404	not_foundHTTP 404Hesabınızda bu kimliğe sahip sipariş yok.	Hesabınızda bu kimliğe sahip sipariş yok.
429	rate_limitedHTTP 429Bir dakikada çok fazla istek.	Bir dakikada çok fazla istek.
500	server_errorHTTP 500İstek tamamlanamadı. Hiçbir ücret alınmadı.	İstek tamamlanamadı. Hiçbir ücret alınmadı.

Uç noktalar

Hesap bilgilerini al

GET/api/v1/accountAPI anahtarı

Bakiyenizi, proxy host'unu, portları, kullanıcı adını ve şifreyi, izinli IP'leri döndürür.

İstek

curl https://royalproxy.online/api/v1/account \
  -H "Authorization: Bearer rpk_your_api_key"

Yanıt

{
  "username": "royal_user",
  "balance_usd": 1300,
  "proxy": {
    "host": "gate.royalproxy.online",
    "http_port": 6100,
    "socks5_port": 6200,
    "username": "rpexample1",
    "password": "your_password"
  },
  "allowed_ips": [
    "203.0.113.10"
  ]
}

Ürünleri ve fiyatları listele

GET/api/v1/productsAnahtar gerekmez

Her ürünü limitleri, fiyat basamakları ve indirimleriyle döndürür. Fiyatlar, fiyatlar sayfasıyla aynı tablodan gelir.

İstek

curl https://royalproxy.online/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/countriesAnahtar gerekmez

Bir ürün için kullanılabilen ülkeleri, proxy kullanıcı adına yazabileceğiniz şehir değerleriyle döndürür.

Alan	Tür	Anlamı
`product`İsteğe bağlı	string	unlimited, residential, isp veya datacenter. Varsayılan residential.

İstek

curl "https://royalproxy.online/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

POST/api/v1/quoteAnahtar gerekmez

Hiçbir ücret almadan bir siparişin toplamını hesaplar. Sipariş verirken kullandığınız gövdenin aynısını kullanın.

Alan	Tür	Anlamı
`product`Zorunlu	string	unlimited, residential, isp veya datacenter.
`quantity`Zorunlu	integer	unlimited 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ı	integer	Yalnızca unlimited: 200, 500, 1000 veya 2000.
`bandwidth`İsteğe bağlı	integer	Yalnızca unlimited, Mbps olarak: 100, 200, 500 veya 1000.
`months`İsteğe bağlı	integer	Yalnızca isp ve datacenter: 1, 3, 6 veya 12.
`country`İsteğe bağlı	string	Yalnızca isp ve datacenter: iki harfli ülke kodu, örneğin jp. /countries bölümüne bakın.

İstek

curl -X POST https://royalproxy.online/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.97,
  "unit": "day",
  "total_usd": 269.1
}

Sipariş verin

POST/api/v1/ordersAPI anahtarı

Toplam tutarı bakiyenizden düşer ve siparişi oluşturur. Yeni siparişler pending (etkinleştiriliyor) olarak başlar ve hazır olduğunda active olur. Bir sipariş etkinleştirilemezse refunded olur ve tutarın tamamı bakiyenize döner. Bakiye yetersizse 402 döner.

Alan	Tür	Anlamı
`product`Zorunlu	string	unlimited, residential, isp veya datacenter.
`quantity`Zorunlu	integer	unlimited 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ı	integer	Yalnızca unlimited: 200, 500, 1000 veya 2000.
`bandwidth`İsteğe bağlı	integer	Yalnızca unlimited, Mbps olarak: 100, 200, 500 veya 1000.
`months`İsteğe bağlı	integer	Yalnızca isp ve datacenter: 1, 3, 6 veya 12.
`country`İsteğe bağlı	string	Yalnızca isp ve datacenter: iki harfli ülke kodu, örneğin jp. /countries bölümüne bakın.

İstek

curl -X POST https://royalproxy.online/api/v1/orders \
  -H "Authorization: Bearer rpk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"product":"unlimited","quantity":30,"concurrency":1000,"bandwidth":200}'

Yanıt

{
  "order": {
    "id": "RP-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.97,
    "total_usd": 269.1,
    "status": "pending",
    "created_at": "2026-10-31T09:12:44.120Z",
    "updated_at": "2026-10-31T09:12:44.120Z"
  },
  "balance_usd": 1030.9
}

Siparişlerinizi listeleyin

GET/api/v1/ordersAPI anahtarı

En yeni 100 siparişinizi, en yeniden başlayarak döndürür.

Alan	Tür	Anlamı
`status`İsteğe bağlı	string	pending, active veya refunded. Tümünü almak için boş bırakın.

İstek

curl "https://royalproxy.online/api/v1/orders?status=pending" \
  -H "Authorization: Bearer rpk_your_api_key"

Yanıt

{
  "orders": [
    {
      "id": "RP-7KQ2M-X4HTD",
      "product": "unlimited",
      "quantity": 30,
      "months": null,
      "concurrency": 1000,
      "bandwidth_mbps": 200,
      "country": null,
      "unit_price_usd": 8.97,
      "total_usd": 269.1,
      "status": "pending",
      "created_at": "2026-10-31T09:12:44.120Z",
      "updated_at": "2026-10-31T09:12:44.120Z"
    }
  ]
}

Tek bir siparişi al

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

Bir siparişi kimliğine göre döndürür, örneğin aktif olup olmadığını kontrol etmek için.

Alan	Tür	Anlamı
`id`Zorunlu	string	Sipariş kimliği, örneğin RP-7KQ2M-X4HTD.

İstek

curl https://royalproxy.online/api/v1/orders/RP-7KQ2M-X4HTD \
  -H "Authorization: Bearer rpk_your_api_key"

Yanıt

{
  "order": {
    "id": "RP-7KQ2M-X4HTD",
    "product": "unlimited",
    "quantity": 30,
    "months": null,
    "concurrency": 1000,
    "bandwidth_mbps": 200,
    "country": null,
    "unit_price_usd": 8.97,
    "total_usd": 269.1,
    "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ı

Seçeneklerinizi içeren bir proxy kullanıcı adı ile hazır HTTP ve SOCKS5 proxy URL'leri döndürür. session olmadan IP her istekte değişir.

Alan	Tür	Anlamı
`product`İsteğe bağlı	string	unlimited, residential, isp veya datacenter. Varsayılan unlimited.
`country`İsteğe bağlı	string	İki harfli ülke kodu, örneğin jp.
`city`İsteğe bağlı	string	/countries listesinden şehir değeri, örneğin tokyo. country gerektirir.
`session`İsteğe bağlı	string	1~32 karakterlik herhangi bir harf veya rakam dizisi. Aynı session değerine sahip istekler aynı IP'yi korur.
`ttl`İsteğe bağlı	integer	Oturum IP'sinin korunacağı dakika, 1~60. Varsayılan 30.

İstek

curl "https://royalproxy.online/api/v1/proxy-user?product=residential&country=jp&city=tokyo&session=job42&ttl=30" \
  -H "Authorization: Bearer rpk_your_api_key"

Yanıt

{
  "username": "rpexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30",
  "password": "your_password",
  "http": "http://rpexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.royalproxy.online:6100",
  "socks5": "socks5h://rpexample1-zone-res-cc-jp-city-tokyo-sid-job42-ttl-30:your_password@gate.royalproxy.online:6200"
}

Tam örnekler

Bu örnekler fiyatı kontrol eder, bakiyeden sipariş verir ve bir Japonya IP'si üzerinden bağlanır.

Python (requests)

import requests

API = "https://royalproxy.online/api/v1"
HEAD = {"Authorization": "Bearer rpk_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://royalproxy.online/api/v1";
const HEAD = { Authorization: "Bearer rpk_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 panelden verilen siparişlerle aynıdır ve History bölümünde görünür. rpk_your_api_key yerine kendi anahtarınızı yazın.

Proxy API belgeleri

Nasıl başlarım?

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

Temel URL ve biçim

Çağrı sınırı var mı?

Hatalar nasıl görünür?

Hesap bilgilerini al

Ürünleri ve fiyatları listele

Ülkeleri ve şehirleri listele

Fiyat teklifi al

Sipariş verin

Siparişlerinizi listeleyin

Tek bir siparişi al

Proxy kullanıcı adı oluşturun

Tam örnekler

RoyalProxy'yi kendi sisteminize bağlayın