ProxyMarket Satıcı Entegrasyonu: Kendi Proxy’lerinizi Satın
AI'a sor
Hazır görevProxyMarket entegrasyonunu kodunuzda oluşturun
Kodlama ajanları
Claude CodeMasaüstü uygulamasını açarCodexMasaüstü uygulamasını açarCursorUygulamayı web'de açarSohbet asistanları
ChatGPT ile açYeni sekmeClaude ile açYeni sekmeKopyala
Markdown olarak görüntüleAI araçları için düz metinİstemi gör
I run my own proxy or VPN platform and want to sell it on ProxyMarket (market.xproxy.io). Read https://xproxy.io/document/proxymarket-vendor-integration.md and the OpenAPI spec https://xproxy.io/docs/api/market.openapi.yaml. If you cannot open links, download them with curl. Then look at my codebase and add, in its language and framework: 1. GET/HEAD /health that answers fast. 2. The HMAC signature check of every webhook (sign the raw body, compare in constant time). 3. The /provision, /deprovision and /settings webhooks, wired to how my platform creates, deletes and updates proxy users or VPN configs. 4. Plan sync and stock updates with the Integration API. 5. Tests for the signature check and for each webhook. Keep the API key in an environment variable. When done, tell me how to check it with one real order. Never print or commit my API keys, passwords or customer logins. Ask me before you open firewall ports, restart services or change config files you did not create. Other XProxy guides, each with a Markdown copy at its URL + .md, are listed in https://xproxy.io/llms.txt. I am reading this page in Turkish: https://xproxy.io/tr/document/proxymarket-vendor-integration. The Markdown copy is in English. Answer in Turkish.
Uygulama, istem doldurulmuş olarak açılır. Enter'a basana kadar hiçbir şey çalışmaz.
Kendi proxy’lerinizi veya VPN’inizi ProxyMarket’te (market.xproxy.io) satın. Sunucularınızı siz çalıştırmaya devam edersiniz. Mağazayı ProxyMarket yönetir, ödemeleri alır ve müşterilere yanıt verir. Sizin tarafınızdaki küçük bir connector ikisini birbirine bağlar: ProxyMarket’e birkaç çağrı yapar ve dört webhook’a yanıt verir.
Gerekenler: market.xproxy.io’da onaylı bir satıcı hesabı, ProxyMarket’in geçerli sertifikalı HTTPS üzerinden ulaşabildiği bir sunucu ve küçük bir web servisi yazabilecek biri. Her endpoint, alan ve yanıt ProxyMarket API referansında da yer alır.
Kısaca
Planlarınızı gönderin, stoğu ve proxy sağlık durumunu güncel tutun ve gerekirse giriş bilgilerini sonradan teslim edin. Her çağrı X-API-Key’inizi taşır.
10 dakikada bir sağlık kontrolü, ardından bir müşteri ödeme yaptığında, bir sipariş bittiğinde ve bir müşteri bir ayarı değiştirdiğinde bir webhook.
Her satıştaki payınız ödeme onaylanır onaylanmaz hesabınıza geçer. ProxyMarket %30’unu mağaza, ödemeler, destek ve iadeler için alır.
Nasıl çalışır?
Yayına geçmenin adımları nelerdir?
Bu sırayla yapın. 1–3. adımlar hesabınızı hazırlar; 4–7. adımlar entegrasyondur.
- market.xproxy.io üzerinde normal bir hesap oluşturunSiz
- Satıcı olmak için başvurun (üst menüde Become Vendor)Siz
- Onay, genellikle 24 saat içinde. O zamana kadar üst menüde Vendor Pending… görünür; hızlandırmak için hesap e-postanızla @xproxyio’ya yazınProxyMarket
- Bu arada sağlık kontrolünüzü oluşturun ve webhook sunucunuzu yayına alınSiz
- Satıcı panelinde API anahtarınızı oluşturunSiz
- Planlarınızı listeleyin, siparişleri işleyin ve webhook imzalarını kontrol edinSiz
- Gerçek bir test siparişi verin ve müşterinin çalışan bir proxy aldığını kontrol edinSiz + ProxyMarket
Sağlık kontrolünü neden önce oluşturmalıyım?
ProxyMarket sunucunuzu HEAD {webhook_url}/health ile kontrol eder. Planlarınızın satışta kalıp kalmayacağına karar veren tek endpoint budur:
- Anahtarınızı oluşturduğunuzda ProxyMarket onu bir kez çağırır. 5xx, reddedilen bağlantı veya 5 saniyeden uzun süre: anahtar yok (nedeniyle birlikte HTTP 422).
- Bundan sonra 10 dakikada bir, anahtarın satışta planı olduğu sürece yeniden çağırır. Üst üste 2 başarısızlıktan sonra, o anahtarın sunduğu tüm planlar mağazada gizlenir ve satın alınamaz. Tek bir başarılı yanıt hepsini kendiliğinden geri getirir.
| Çalışıyor sayılır | Çalışmıyor sayılır |
|---|---|
| 5 saniye içinde 500’ün altındaki herhangi bir durum kodu. Giriş ve gövde gerekmez. | Zaman aşımı, reddedilen bağlantı veya herhangi bir 5xx durum kodu. |
@app.route("/health", methods=["HEAD", "GET"])
def health():
return "", 200 # no login, no database, no outside callWebhook URL’nizin altına koyun: https://your-vendor-host.com/marketplace ile /marketplace/health adresinde yanıt verir.
HEAD’i engelleyen bir güvenlik duvarı, tüm kataloğunuzu yaklaşık 20 dakikada boşaltabilir. /health’i elinizdeki en basit route yapın: giriş yok, veritabanı yok, dış çağrı yok; GET’e de yanıt verin. Bunu Proxy’lerinizin sağlık durumunu bildirme (POST /api/integration/health) ile karıştırmayın. O, tek tek proxy’ler hakkında sizin yaptığınız bir çağrıdır; planlarınızı listede tutmaz.
API anahtarımı nasıl alırım?
Satıcı başvurunuz onaylandıktan sonra anahtarı kendiniz oluşturursunuz; kimse size göndermez. Satıcı panelinde anahtara bir ad ve webhook URL’nizi verin, örneğin https://your-vendor-host.com/marketplace. Bunu tek bir çağrıyla da yapabilirsiniz (referans):
curl -X POST "https://market.xproxy.io/api/vendor/integrations" \
-H "Authorization: Bearer $PROXYMARKET_LOGIN_JWT" \
-H "Content-Type: application/json" \
-d '{"name": "primary-instance", "webhook_url": "https://your-vendor-host.com/marketplace"}'
# {"api_key": "pm_..."} <- shown only this once, save it nowBu tek anahtardan iki değer elde edersiniz. Bunları birbirinden ayrı tutun:
| Değer | Nedir | Ne için kullanılır |
|---|---|---|
api_key | Anahtarın kendisi, pm_ ile başlar | Yaptığınız her çağrıdaki X-API-Key başlığı |
signing_key | 64 karakterlik hex olarak SHA256(api_key) | Her webhook’un X-Signature’ını kontrol etmek (nasıl) |
Anahtarın süresi hiç dolmaz ve webhook URL’si sonradan değiştirilemez: sunucu değiştirmek için yeni bir anahtar oluşturun. Birkaç bağımsız sunucu çalıştırıyorsanız her birine kendi anahtarını verin. Siparişler, satıcı panelinde her planın API Key / Server alanında ayarlı anahtara gider. Bir senkronizasyonla oluşturulan plan, onu senkronize eden anahtarı alır; bu ayarı olmayan eski bir plan siparişlerini en eski aktif anahtarınıza gönderir.
pm-connector test, bir plan başka yere gittiğinde uyarır. Hatalar: X-API-Key başlığı olmayan bir çağrı 422, yanlış bir anahtar 401, satıcı başvurusu hâlâ beklemede olan bir anahtar 403 alır. Satıcı panelinin Integration Status sekmesi her anahtar için en son ne zaman görüldüğünü, connector sürümünü ve son 20 teslimatı sonuçlarıyla gösterir.
Planlarımı nasıl listelerim?
Connector’ınız başladığında ve bir şey her değiştiğinde tüm ürünlerinizi Planlarınızı yayınlama veya güncelleme ile gönderin. Senkronize edilen planlar hemen onaylanır (panelde elle eklediğiniz planlar bir yöneticiyi bekler). external_id, ürün için kendi kimliğinizdir (bir port, bir modem, bir VPN havuzu) ve sonraki her çağrı ile webhook bunu kullanır.
curl -X POST "https://market.xproxy.io/api/integration/plans/sync" \
-H "X-API-Key: $PROXYMARKET_API_KEY" \
-H "Content-Type: application/json" \
-d '[{
"external_id": "port-1",
"name": "US Mobile 4G - Port 1",
"proxy_type": "mobile",
"protocol": "HTTP",
"country": "United States",
"duration_days": 30,
"price_usd": 25.00,
"stock": 1,
"is_active": true
}]'
# {"created": 1, "updated": 0, "plans": [{"plan_id": "...", "external_id": "port-1", "status": "created"}]}| Bilmekte fayda var | Neden |
|---|---|
Aynı external_id’yi yeniden göndermek planı günceller | Senkronizasyonu tekrarlamak güvenlidir; asla kopya oluşturmaz. |
| Göndermediğiniz bir plan satışta kalır | Satışı durdurmak için Bir planı satıştan kaldırma çağrısını yapın. |
proxy_type olarak yalnızca mobile, residential, datacenter, isp, ipv6 veya vpn kullanın | API her metni kabul eder ama başka bir değer siparişi bozar: müşteri hiçbir zaman giriş bilgisi almaz. VPN ve VLESS’e bakın. |
country, tam İngilizce addır, örneğin United States | Müşteriler tam metne göre filtreler, bu yüzden her planda aynı şekilde yazın (daha fazlası). ProxyMarket bunu kontrol etmez. |
| Bir plan yalnızca aktif, stokta, listelenmiş ve sağlık kontrolüyle gizlenmemişse gösterilir | stock genellikle modem portu başına 1’dir: port başına bir müşteri. |
protocol gönderilmezse HTTP sayılır | VPN ve SOCKS5 planları için yine de gönderin. |
| Bir senkronizasyonla oluşturulan plan, onu senkronize eden anahtara sabitlenir | Siparişleri o anahtara gider. Senkronizasyon, zaten var olan bir planın anahtarını asla değiştirmez (daha fazlası). |
Biri satın aldığında ne olur?
- Müşteri öder. %70’iniz, sunucunuz daha çağrılmadan hemen bakiyenize eklenir.
- ProxyMarket,
order_idveexternal_plan_id’nizlePOST {webhook_url}/provisionçağrısını yapar (payload). İmzayı kontrol edin, ardından müşterinin erişimini oluşturun. - Giriş bilgileri veya yapılandırmayla (en iyisi),
pendingile ya daerrorile yanıt verirsiniz. Aşağıdaki tabloya bakın. - Müşteri giriş bilgilerini ProxyMarket’te görür ve sunucunuza bağlanır. ProxyMarket planın stoğunu kendiliğinden bir azaltır.
- Süre dolduğunda ProxyMarket siparişi kendiliğinden bitirir (5 dakikada bir kontrol eder) ve
POST {webhook_url}/deprovisionçağrısını yapar. Siz erişimi kaldırır ve birimi yeniden satışa çıkarırsınız. Bir sipariş bittiğinde bölümüne bakın.
Yanıt verdiğiniz status | Ne zaman kullanılır | Ne olur |
|---|---|---|
provisioned (en iyisi) | Erişimi hemen oluşturabiliyorsunuz | Müşteri hemen alır. proxy_ip, proxy_port, proxy_username, proxy_password dördünü birden, VPN için de vpn_config_file’ı ekleyin. |
pending | Kurulum biraz zaman alıyor | Bilgileri Proxy giriş bilgilerini veya VPN yapılandırmasını teslim etme ile gönderin. ProxyMarket, başlangıçtan itibaren toplam 120 saniye bekler; sonrasında sipariş iade edilir ve geç bir teslimat 409 alır. |
error | Teslim edemiyorsunuz (port çevrimdışı, boş profil yok) | Hiçbir şey teslim edilmez. 120 saniyeden sonra müşteriye cüzdanına iade yapılır ve kazancınız düşülür. |
/provision başka bir durum koduyla yanıt verir, zaman aşımına uğrar (30 saniye sonra), geçersiz JSON döndürür veya eksik giriş bilgileriyle provisioned derse ProxyMarket müşteriye, varsa planda senkronize ettiğiniz giriş bilgilerini verir. Teslim edilen bir giriş asla plana kopyalanmaz ve zaten başka bir siparişe ait olan plan girişi yeniden kullanılmaz: o sipariş iade edilir. Çağrı tekrarlanmaz. Yanıtınızdaki expires_at yok sayılır: ProxyMarket süreyi aktivasyondan itibaren sayar ve size /deprovision’da bildirir.
Düz bir http:// URL’sinde yanıtı şifreleyebilir miyim?
Evet, isteğe bağlı olarak. X-PM-Encrypted: v1 ve X-PM-Signature: sha256= + ham gövdenin imzalama anahtarınızla oluşturulan hex HMAC-SHA256 değeri başlıklarıyla ve {"enc": "v1", "nonce": "…", "ct": "…"} gövdesiyle 200 yanıtı verin: rastgele 12 baytlık bir nonce ve normal yanıtınızın AES-256-GCM şifreli metni (tag sona eklenmiş), ikisi de standart base64. Anahtar, imzalama anahtarınızın UTF-8 baytları üzerinde HKDF-SHA256’dır (boş salt, info pm-provision-v1, 32 bayt), AAD ise order_id’dir. ProxyMarket imzayı kontrol eder, şifreyi çözer ve yanıtı her zamanki gibi okur; hatalı bir zarf zaman aşımı gibi sayılır. Tam biçim ve bir test vektörü API referansında ve rehberin 5.1 bölümündedir. pm-connector bunu bir http:// URL’sinde kendiliğinden yapar. Webhook istekleri şifrelenmediği için HTTPS yine de önerilir.
order_id’yi kaydedin: geç teslimat yapmak, siparişi kendiniz bitirmek ve diğer webhook’larla eşleştirmek için ona ihtiyacınız var.
Bir webhook’un gerçekten ProxyMarket’ten geldiğini nasıl kontrol ederim?
Her webhook POST’u, ham gövdenin HMAC-SHA256 değeri olan X-Signature: sha256=… taşır. Gizli anahtar, API anahtarının kendisi değil, hex olarak SHA256(api_key) olan imzalama anahtarınızdır. Başka bir şey yapmadan önce bunu /provision, /deprovision ve /update-settings’te kontrol edin.
import hashlib, hmac, os
API_KEY = os.environ["PROXYMARKET_API_KEY"]
# The HMAC secret is SHA256(api_key) as hex, NOT the raw key. Compute it once.
SIGNING_KEY = hashlib.sha256(API_KEY.encode()).hexdigest()
def verify_signature(raw_body: bytes, header: str) -> bool:
expected = "sha256=" + hmac.new(SIGNING_KEY.encode(), raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, header or "")
# Flask: sign the raw bytes, before you parse the JSON
@app.route("/provision", methods=["POST"])
def provision():
if not verify_signature(request.get_data(), request.headers.get("X-Signature", "")):
return jsonify({"status": "error", "message": "Invalid signature"}), 401
data = request.get_json()
...Ham istek gövdesini kullanın. JSON’u ayrıştırıp yeniden yazdırmak baytları değiştirir ve imza artık eşleşmez.
Müşteriler satın almadan önce nasıl test ederim?
- Ağınızın dışından
curl -I https://your-vendor-host.com/marketplace/healthçalıştırın ve 5 saniye içinde 500’ün altında bir durum kodu aldığınızı kontrol edin. - Bir planı senkronize edin ve market.xproxy.io’da Browse içinde bulun.
- Onun için gerçek bir sipariş verin. Sunucunuz geçerli imzalı
/provisionalmalı ve giriş bilgileri müşterinin siparişinde görünmelidir. - Bu girişle bağlanın, ardından siparişin bitmesini bekleyin (veya bitirilmesini Telegram’dan isteyin) ve
/deprovision’ın erişimi kaldırdığını ve stoğun geri geldiğini kontrol edin.
Test siparişini verdiğinizde ProxyMarket’e Telegram @xproxyio üzerinden haber verin; böylece onlar da kendi taraflarından kontrol edebilir.
Stoğu ve sağlık durumunu nasıl güncel tutarım?
| Sizin tarafınızda bu olduğunda | Çağrı |
|---|---|
| Bir modem veya sunucu çevrimdışı olur | stock: 0, is_active: false ile PATCH /plans/stock |
| Yeniden çevrimiçi olur veya satılmış bir port yeniden boşalır | stock: 1, is_active: true ile PATCH /plans/stock |
| Bir fiyat, ad veya yapılandırma değişir | Yalnızca o planla POST /plans/sync |
| Bir ürünü satmayı bırakırsınız | DELETE /plans/{external_id} |
| İsteğe bağlı, birkaç dakikada bir | Her proxy’nin durumu ve güncel IP’siyle POST /health. Her zaman current_ip ekleyin: göndermezseniz kayıtlı IP silinir. Planlarınızı listede tutmaz; bunu sunucunuzun sağlık kontrolü yapar. |
Tüm yollar https://market.xproxy.io/api/integration ile başlar.
Bir sipariş bittiğinde ne olur?
ProxyMarket bir reason ile POST {webhook_url}/deprovision çağrısını yapar:
| Neden | Anlamı |
|---|---|
expired | Kiralama süresi doldu. Otomatik gönderilir, en fazla 5 dakika gecikmeyle. |
renewed | Müşteri çalışan bir siparişi yenilemek için ödeme yaptı. Eski sipariş şimdi biter ve ardından yeni bir order_id ile yeni bir /provision gelir. |
cancelled | Bir yönetici siparişi iptal etti. |
admin_refund | Bir yönetici müşteriye iade yaptı. Bu siparişten kazancınız geri alınır. |
Müşterinin girişini kaldırın (veya VPN profilini kapatın). Ardından gerçek boş birim sayınızı PATCH /plans/stock ile gönderin: ProxyMarket bir iadeden sonra stoğu kendiliğinden geri koyar, ama süre dolduktan sonra koymaz. {"status": "deprovisioned"} ile yanıt verin; yanıt yalnızca günlüğe kaydedilir.
/provision’dan bilirsiniz). Kurulumu başarısız olup otomatik iade edilen bir sipariş hiç /deprovision almaz. Bir siparişi süresi dolmuş olarak işaretleme, yalnızca ProxyMarket’teki durumunu değiştirir; her durumda, iptal edilmiş olsa bile. Müşteriye iade yapmaz, stoğu değiştirmez ve webhook’unuzu çağırmaz.
Bir müşteri IP beyaz listesini veya TCP parmak izini değiştirirse ne olur?
Bir müşteri aktif bir siparişte Proxy Settings’i kaydettiğinde ProxyMarket POST {webhook_url}/update-settings çağrısını yapar. Her sipariş türü için bir kez gönderilir. Sisteminizin desteklediğini uygulayın ve {"status": "ok"} ile yanıt verin; desteklemediğiniz bir alanı yok sayabilirsiniz. Gövdede external_plan_id yoktur, bu yüzden planı provision sırasında kaydettiğiniz order_id’den bulun.
ip_whitelist: proxy’yi yalnızca bu IP’ler kullanabilir. Her zaman tek tek adreslerden oluşan bir listedir;[], IP sınırı olmadığı anlamına gelir.tcp_fingerprint: bağlantının hangi işletim sistemi gibi görüneceği (win1Windows 11,mac1macOS,ios1iPhone 15,android1Galaxy S24 ve diğerleri).nullbunu kapatır.
VPN ve VLESS nasıl satarım?
Sipariş akışı aynıdır; yalnızca teslim ettiğiniz şey değişir. Eksiksiz istemci dosyasını, müşterinin içe aktarması gerektiği haliyle gönderin.
| Ürün | Plan alanları | Teslim ettiğiniz |
|---|---|---|
| OpenVPN | proxy_type: "vpn", protocol: "OpenVPN", vpn_protocol: "openvpn" | Sertifikalar ve anahtarlar içinde olan tam .ovpn metni |
| WireGuard | proxy_type: "vpn", protocol: "WireGuard", vpn_protocol: "wireguard" | [Interface] ve [Peer] içeren tam .conf |
| VLESS (Xray) | proxy_type: "vpn", protocol: "VLESS", vpn_protocol: "vless" | Tek satırlık bir vless:// bağlantısı veya tam Xray istemci JSON’u |
proxy_type: "xray" göndermeyin. Mağaza VLESS planlarını “Xray” olarak gösterir, ama bu etiket vpn_protocol’den gelir. xray API tarafından kabul edilir ve ardından planı bozar: müşteri öder ve yapılandırma hiç gelmez. Dosyayı teslim etmenin üç yolu:
- Plandaki herkes için aynı dosya: senkronize ederken onu
vpn_config_template’e koyun. - Her sipariş için yeni bir dosya: onu
/provision’da oluşturun vevpn_config_fileile yanıt verin. - Zaman alan yeni bir dosya:
pendingile yanıt verin, ardındanvpn_config_file’ı Proxy giriş bilgilerini veya VPN yapılandırmasını teslim etme ile gönderin.
VLESS için her siparişe kendi UUID’sini verin (tek UUID paylaşmak, bir müşteriyi iptal etmenin herkesi iptal etmesi demektir), aktarım yöntemini plan açıklamasında belirtin (örneğin XTLS-Reality veya WS+TLS) ve sipariş bitince UUID’yi inbound’unuzdan kaldırın.
Bir OpenVPN dosyası remote, dev tun veya dev tap ya da hem client hem bir <ca> bloğu içermelidir; tek başına bir <ca> bloğu reddedilir. Her yapılandırma en az 50 karakter olmalıdır.
IP rotasyonu nasıl çalışır?
Teslim ettiğiniz rotation_link, ProxyMarket’in kendisinin düz bir GET ile çağırdığı bir URL’dir (yönlendirmeler izlenir, sertifika kontrol edilmez, 15 saniyelik zaman aşımı). Bunu müşteri Rotate’e bastığında ve müşterinin seçtiği otomatik rotasyon zamanlayıcısında (5 ila 60 dakikada bir) yapar, sipariş bitince durur. Müşteri bağlantıyı da görür ve açabilir.
Planın kendi rotation_link’i yedek olarak verilirse (yukarıya bakın), bu asla başka bir siparişe zaten ait olan bir bağlantı olmaz.
Hazır bir webhook sunucusu var mı?
Evet: ProxyMarket connector (pm-connector), Linux veya Windows sunucunuzda çalışır ve bu sayfadaki her şeyi sizin yerinize yapar. Ona yalnızca sisteminizde müşterinin giriş bilgilerini ekleyip silen küçük bir betik verirsiniz; Python, Node.js ve shell için hazır betikler kendi sayfasındadır.
- Webhook’lara imza kontrolüyle yanıt verir, müşterinin kullanıcı adını ve şifresini sisteminizde oluşturur ve kiralama bitince siler.
- ProxyMarket’e ProxyMarket hook üzerinden ulaşır (anahtar türü ProxyMarket hook):
market-hook-service.xproxy.io’ya giden tek bir bağlantı; bu yüzden sunucunun açık porta ve alan adına ihtiyacı yoktur. Müşteriler her zaman proxy portunuza doğrudan bağlanır. - Kesintiden sonra eksikleri tamamlar: çevrimdışıyken biten siparişlerin kullanıcıları, connector geri gelir gelmez kaldırılır.
Planları Vendor Dashboard’da oluşturursunuz. ProxyMarket’in hook yerine kendi HTTPS adresinizi çağırmasını istiyorsanız kendi adresinizi kullanma bölümüne bakın.
Nasıl ödeme alırım?
| Payınız | Her satışın %70’i (standart oran; satıcı bazında kararlaştırılabilir) |
|---|---|
| ProxyMarket payı | %30, mağaza, ödemeler, destek ve iadeler için |
| Ne zaman eklenir | Müşterinin ödemesi onaylanıp sipariş aktif olur olmaz, /provision’ınız çağrılmadan önce |
| Nerede görülür | Satıcı panelinizdeki Earnings: her satış, tutarı, sizin tutarınız ve kullanılan oranla |
| Ödemeler | ProxyMarket yöneticisi tarafından bakiyenizden ödenir. Çekmek istediğinizde Telegram’dan yazın. |
| İadeler | Otomatik bir iade (120 saniye içinde hiçbir şey teslim edilmedi) veya yönetici iadesi kazancı bakiyenizden düşer. Promosyon kodu satış tutarını, onunla birlikte de payınızı düşürür. |
| Para çekme | Bir ödeme en fazla bakiyeniz kadar olabilir ve en eski ödenmemiş kazançlarınızı ödendi olarak işaretler. |
Oran her satışla birlikte kaydedilir; bu yüzden sonraki bir oran değişikliği zaten kazandığınız paraya asla dokunmaz.
Planlarım mağazada nerede görünür?
Browse planları en ucuzdan başlayarak listeler; fiyat belirlemeden önce bilmeniz gereken bir kural var: XProxy yazılımı çalıştıran satıcıların planları önce gelir, Powered by xProxy başlığı altında ve xProxy rozetiyle. Kendi connector’ınızdan gelen planlar ardından, Other vendors başlığı altında, yine en ucuzdan başlayarak gelir.
| Nerede | Sırayı ne belirler |
|---|---|
| Browse, varsayılan | Önce XProxy grubu, sonra sizinki; her biri en ucuzdan başlayarak |
| Browse, müşteri sıraladığında | Sıralama her grubun içinde uygulanır; bu yüzden sizin daha ucuz planınız yine XProxy grubunun altında kalır |
| Ana sayfadaki “from $X” kartları | Her kategorinin en ucuz XProxy planı; sizinki yalnızca XProxy’nin orada stoğu yoksa |
| Ülke, protokol ve arama filtreleri, mağaza sayfanız | Her satıcı için tamamen aynı |
Listelenen her şey tek bir gruba aitse Browse başlıksız tek düz bir liste gösterir. Müşterilerin çoğu bir ülkeye veya protokole göre filtreleyerek gelir; orada planlarınız herkesinkinin yanında durur.
Hata kodları ne anlama gelir?
| Kod | Anlamı | Yapmanız gereken |
|---|---|---|
401 | Invalid API key (yanlış veya kapatılmış anahtar), Missing API key (boş başlık) veya Vendor inactive | X-API-Key başlığını ve anahtarın panelde açık olduğunu kontrol edin |
403 | Satıcı başvurunuz hâlâ beklemede (her çağrıda) veya hesap onaylı bir satıcı değil (anahtar oluşturma) | Onayı bekleyin |
404 | Bilinmeyen external_id veya order_id | Kimliği kontrol edin; önce planı senkronize edin |
409 | Artık ödenmiş veya aktif olmayan bir siparişe giriş bilgisi teslim etmek | Genellikle 120 saniye geçmiş ve sipariş iade edilmiştir. Tekrar denemeyin |
422 | Bir değer geçersiz veya X-API-Key başlığı hiç yok | Yanıttaki detail alanı adlandırır |
500 | ProxyMarket hatası | Giderek artan bir bekleme süresiyle tekrar deneyin |
Hatalar {"detail": "…"} olarak döner. Yayınlanmış bir istek sınırı yoktur; sıkı bir döngüde değil, değişiklik olduğunda senkronize edin.
Tam bir örnek var mı?
Evet. Bu Python connector bir proxy planını senkronize eder, 5 dakikada bir sağlık durumunu bildirir ve dört webhook’un hepsine yanıt verir. En üstteki iki fonksiyonu kendi sisteminize yapılan çağrılarla değiştirin ve süresi dolan her siparişi bitiren bir zamanlayıcı ekleyin.
"""Minimal ProxyMarket connector: sync plans, report health, answer the four webhooks."""
import hashlib
import hmac
import os
import secrets
import threading
import time
import requests
from flask import Flask, jsonify, request
API_KEY = os.environ["PROXYMARKET_API_KEY"] # pm_... from "Create your API key"
MARKET = "https://market.xproxy.io/api/integration"
HEADERS = {"X-API-Key": API_KEY, "Content-Type": "application/json"}
SIGNING_KEY = hashlib.sha256(API_KEY.encode()).hexdigest()
# ── Your system (replace with your own code) ─────────────────────────
PORTS = {
"port-1": {"name": "US Mobile 4G - Port 1", "country": "United States", "protocol": "HTTP",
"price": 25.00, "days": 30, "online": True, "ip": "203.0.113.1", "port": 8080},
}
def add_proxy_login(port_id, username, password): ... # create the customer's login
def remove_proxy_login(port_id, order_id): ... # delete it again
# ── Calls you make ───────────────────────────────────────────────────
def sync_plans():
plans = [{
"external_id": pid, "name": p["name"], "proxy_type": "mobile", "protocol": p["protocol"],
"country": p["country"], "duration_days": p["days"], "price_usd": p["price"],
"stock": 1 if p["online"] else 0, "is_active": p["online"],
} for pid, p in PORTS.items()]
r = requests.post(f"{MARKET}/plans/sync", json=plans, headers=HEADERS, timeout=15)
print("[sync]", r.status_code, r.json())
def set_stock(port_id, free):
requests.patch(f"{MARKET}/plans/stock", headers=HEADERS, timeout=15,
json=[{"external_id": port_id, "stock": 1 if free else 0, "is_active": free}])
def health_reporter():
while True:
try:
reports = [{"external_id": pid, "status": "online" if p["online"] else "offline",
"current_ip": p["ip"]} for pid, p in PORTS.items()]
requests.post(f"{MARKET}/health", json=reports, headers=HEADERS, timeout=15)
except requests.RequestException as e:
print("[health]", e)
time.sleep(300) # every 5 minutes
# ── Webhooks ProxyMarket calls ───────────────────────────────────────
app = Flask(__name__)
def signed():
expected = "sha256=" + hmac.new(SIGNING_KEY.encode(), request.get_data(), hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, request.headers.get("X-Signature", ""))
@app.route("/health", methods=["HEAD", "GET"])
def health():
return "", 200
@app.route("/provision", methods=["POST"])
def provision():
if not signed():
return jsonify({"status": "error", "message": "Invalid signature"}), 401
data = request.get_json()
port = PORTS.get(data["external_plan_id"])
if not port or not port["online"]:
return jsonify({"status": "error", "message": "Port offline"}) # ProxyMarket refunds the customer
username = f"cust_{data['order_id'][:8]}"
password = secrets.token_urlsafe(16)
add_proxy_login(data["external_plan_id"], username, password)
set_stock(data["external_plan_id"], free=False)
return jsonify({
"status": "provisioned",
"proxy_ip": port["ip"], "proxy_port": port["port"],
"proxy_username": username, "proxy_password": password,
})
@app.route("/deprovision", methods=["POST"])
def deprovision():
if not signed():
return jsonify({"status": "error", "message": "Invalid signature"}), 401
data = request.get_json()
remove_proxy_login(data["external_plan_id"], data["order_id"]) # must be safe to run twice
set_stock(data["external_plan_id"], free=True)
return jsonify({"status": "deprovisioned"})
@app.route("/update-settings", methods=["POST"])
def update_settings():
if not signed():
return jsonify({"status": "error", "message": "Invalid signature"}), 401
data = request.get_json()
# data["ip_whitelist"]: [] = allow everyone, None = leave as it is
# data["tcp_fingerprint"]: "win1", "ios1", ... or None = no spoofing
return jsonify({"status": "ok"}) # apply what you support, ignore the rest
if __name__ == "__main__":
sync_plans()
threading.Thread(target=health_reporter, daemon=True).start()
# Serve this behind HTTPS at your webhook_url, for example https://your-vendor-host.com/marketplace
app.run(host="0.0.0.0", port=9090)Tam API referansı nerede?
Her çağrı ve webhook, tüm alanları, örnek yanıtları ve curl, Python, Node.js ve PHP kodlarıyla ProxyMarket API referansında yer alır. OpenAPI 3.1 dosyası market.openapi.yaml adresindedir.
| Yön | Endpoint | Ne yapar |
|---|---|---|
| Siz çağırırsınız | POST /api/vendor/integrations | API anahtarınızı oluşturur |
| Siz çağırırsınız | POST /plans/sync | Planları yayınlar veya günceller |
| Siz çağırırsınız | PATCH /plans/stock | Stoğu ve görünürlüğü değiştirir |
| Siz çağırırsınız | DELETE /plans/{external_id} | Bir planı satıştan kaldırır |
| Siz çağırırsınız | POST /health | Proxy’lerinizin durumunu bildirir |
| Siz çağırırsınız | POST /orders/{order_id}/credentials | Giriş bilgilerini veya yapılandırmayı sonradan teslim eder |
| Siz çağırırsınız | POST /orders/{order_id}/expire | Bir siparişi süresi dolmuş olarak işaretler (iade yok) |
| Biz sizi çağırırız | HEAD /health | Planlarınızı listede tutan sağlık kontrolü |
| Biz sizi çağırırız | POST /provision | Bir müşteri ödedi: teslim edin |
| Biz sizi çağırırız | POST /deprovision | Bir sipariş bitti: erişimi kaldırın |
| Biz sizi çağırırız | POST /update-settings | Yeni bir IP beyaz listesi veya TCP parmak izi uygulayın |
| Siz çağırırsınız | GET /orders/active | Anahtarınıza yönlendirilen ödenmiş ve aktif siparişler |
Hangi ülkeleri listeleyebilirim?
Hepsini. Tam İngilizce ülke adını gönderin, örneğin United States, Germany veya Vietnam, ve her planda aynı şekilde yazın: müşteriler tam metne göre filtreler. ProxyMarket adı kontrol etmez; rehberdeki ve satıcı panelindeki liste, kullanılacak yazımdır. pm-connector test, bu listede olmayan bir adı reddeder.
1.13 sürümünde neler değişti?
- Yeni çağrı: kesintiden sonra eksikleri tamamlamak için Anahtarınıza yönlendirilen siparişleri listeleme (
routed_plansve ETag ileGET /orders/active). - Daha güvenli yedek: teslim edilen bir giriş artık plana kopyalanmaz ve başka bir siparişe ait olan bir plan girişi veya rotasyon bağlantısı asla verilmez.
- Provision zamanlaması:
/provisionyalnızca ödeme kesinleştikten sonra gönderilir; bu yüzden hemen yapılan bir giriş bilgisi gönderimi kabul edilir./update-settingsher zaman müşterinin az önce kaydettiği değerleri taşır. - ProxyMarket connector: NAT arkasında ona nasıl ulaşılacağı dahil hazır bir webhook sunucusu. Connector bölümüne bakın.
- Şifreli provision yanıtı (isteğe bağlı): düz bir
http://webhook URL’sinde/provisionyanıtınızıX-PM-Encrypted: v1ile mühürleyin. Yukarıya bakın. - Plan sabitleme: bir senkronizasyonla oluşturulan plan, onu senkronize eden anahtara gider.
- Rotasyon: ProxyMarket
rotation_link’iniziGETile çağırır. IP rotasyonu bölümüne bakın. - Satıcı panelinde Integration Status sekmesi ve isteğe bağlı
X-PM-Connectorbaşlığı. - Koda uygun olarak belgelendi:
X-API-Keybaşlığı olmadan 422, başvurunuz beklemedeyken 403, 30 saniyelik provision zaman aşımı, doğrulanmayan ülke ve senkronizasyon portu,protocol’ün varsayılanı HTTP,current_ipolmayan bir/healthraporunun onu silmesi, OpenVPN<ca>kuralı ve/update-settings’teexternal_plan_idolmaması.
SSS
XProxy kullanıyorum. Bunu geliştirmem gerekir mi?
Hayır. Panelde ProxyMarket’i açın (Selling Platform → ProxyMarket); webhook’lar dahil bunların hepsini sizin yerinize yapar. ProxyMarket’te satış sayfasına bakın. Planlarınız ayrıca xProxy rozetini de alır.
Neden tüm planlarım mağazadan kayboldu?
Neredeyse her zaman sağlık kontrolü yüzünden: HEAD {webhook_url}/health üst üste iki kez başarısız oldu (kapalı, 5 saniyeden yavaş, 5xx veya HEAD engellenmiş). Düzeltin; planlar bir sonraki başarılı kontrolden sonra, 10 dakika içinde geri gelir.
API anahtarımı kaybettim. ProxyMarket yeniden gönderebilir mi?
Hayır. Yalnızca bir hash saklanır. Yeni bir anahtar oluşturun ve imzalama anahtarının da onunla birlikte değiştiğini unutmayın.
İmza kontrolüm hep başarısız oluyor. Neden?
Genellikle iki şeyden biri: HMAC gizli anahtarı olarak hex SHA256(api_key) yerine ham API anahtarını kullandınız ya da ham istek gövdesi yerine ayrıştırılıp yeniden kodlanmış JSON’u imzaladınız.
Sunucum teslim edemezse ödeme alır mıyım?
Hayır. 120 saniye içinde kullanılabilir bir şey gelmezse müşteriye iade yapılır ve kazanç bakiyenizden düşülür.
Bir müşteri neden eski bir giriş bilgisi aldı?
/provision’ınız 200 dışında bir durum koduyla yanıt verdi, zaman aşımına uğradı veya geçersiz JSON gönderdi; bu yüzden ProxyMarket planda senkronize ettiğiniz girişi verdi. Teslim edilen bir giriş asla plana kaydedilmez ve plan girişi zaten başka bir siparişe aitse yeniden kullanılmaz (bunun yerine o sipariş iade edilir). Her zaman 200 ile, teslim edemiyorsanız error ile yanıt verin.
Birkaç sunucu bağlayabilir miyim?
Evet. Her sunucu için, her biri kendi webhook URL’siyle bir anahtar oluşturun. Bir senkronizasyonla oluşturulan plan, onu senkronize eden anahtara gider; eski planlar için panelde API Key / Server’ı ayarlayın, aksi halde siparişleri en eski anahtarınıza gider.
Bir müşteri yenileme yaptığında ne olur?
Süresi dolmuş bir siparişi yenilemek normal bir yeni sipariştir. Çalışan bir siparişi yenilemek önce eski sipariş için reason: renewed ile /deprovision, ardından yeni sipariş için yeni bir order_id ile /provision gönderir.
Sırada ne var?
Tam referansı açın veya ProxyMarket’e Telegram’dan sorun.

