IP planları için geliştirici API

JSON yanıtları olan küçük bir REST API: anahtar olmadan planları, ülkeleri ve tam fiyatları okuyun ve API anahtarınızla krediyi kontrol edin ve plan satın alın. Her yanıtta ok: true veya false bulunur.

Temel URL: https://proxyworld.cc/api/v1
Kimlik Doğrulama: Authorization: Bearer pwk_...
Biçim: JSON over HTTPS
Sınır: Anahtar başına dakikada 300 istek

Uç Noktalar

Yöntem	Yol	Anahtar	Ne yapar
GET	/plans	Hayır	30 günlük birim fiyatı, hacim fiyatları, minimum ve maksimum miktar ve izin verilen ülkelerle tüm planlar.
GET	/countries	Hayır	Bölge hattı, şehirler ve bulut kullanılabilirliği ile 24 ülke.
GET	/price?plan=rotate-max&quantity=2&days=90	Hayır	Bir plan, miktar ve süre (30, 90, 180 veya 360 gün) için tam toplam.
GET	/balance	Evet	Hesaptaki kredi ABD doları cinsinden.
POST	/orders	Evet	Krediden bir plan satın alın. Gövde: plan, miktar, günler, ülke (bir ülke alan planlar için).
GET	/orders	Evet	Durum ve erişim detayları ile son 100 siparişiniz.
GET	/orders/{id}	Evet	Kodu (PO-...) ile bir sipariş.

Örnekler

cURL

curl -s https://proxyworld.cc/api/v1/price?plan=static-ip\&quantity=10\&days=30

curl -s -X POST https://proxyworld.cc/api/v1/orders \
  -H "Authorization: Bearer pwk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"plan":"static-ip","quantity":10,"days":30,"country":"DE"}'

Python

import requests
KEY = "pwk_YOUR_KEY"
r = requests.post("https://proxyworld.cc/api/v1/orders",
    headers={"Authorization": f"Bearer {KEY}"},
    json={"plan": "rotate-max", "quantity": 2, "days": 90})
print(r.status_code, r.json())

Node.js

const r = await fetch("https://proxyworld.cc/api/v1/orders", {
  method: "POST",
  headers: { Authorization: "Bearer pwk_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ plan: "cloud-pc-b", quantity: 2, days: 30, country: "NL" }),
});
console.log(r.status, await r.json());

POST /orders yanıtı

{
  "ok": true,
  "order": {
    "id": "PO-7KQ2M9XHTA",
    "product": "static",
    "plan": "static-ip",
    "quantity": 10,
    "days": 30,
    "country": "DE",
    "price": "40.20",
    "status": "processing",
    "status_text": "Setting up",
    "created_at": "2026-11-05T09:00:00.000Z",
    "active_at": null,
    "ends_at": null,
    "access": null
  }
}

Yeni bir sipariş işlem olarak başlar ve hizmet hazır olduğunda aktif olur; erişim daha sonra giriş kodunu (uygulama planları), proxy listesini ve kullanıcıyı (proxy planları) veya Uzak Masaüstü adreslerini (bulut PC'ler) içerir. Değişene kadar birkaç saniyede bir GET /orders/{id} sorgulayın.

Hatalar

HTTP	hata	Anlam
400	bad_plan, bad_qty, bad_days, bad_country	İşlem ücretlendirilmeden önce istek kontrol edilir.
401	unauthorized	Authorization: Bearer pwk_... başlığını gönderin.
402	funds	Bakiye fiyattan düşük; cevap ihtiyaç duyulan miktarı (need) içerir. Hiçbir ücret alınmaz.
429	rate_limited	Bir dakikada bir anahtar üzerinden 300'den fazla istek.
503	network	Hizmet şu anda kurulamadı; hiçbir ücret alınmaz. Daha sonra tekrar deneyin.

Konsolda API altında yeni bir anahtar oluşturun veya mevcut anahtarınızı değiştirin. Anahtar yalnızca bir kez gösterilir ve yalnızca hash olarak saklanır; değiştirildiğinde eski anahtar anında devre dışı kalır.