Integrasi Vendor ProxyMarket: Jual Proksi Anda Sendiri
Tanya AI
Tugasan sediaBina integrasi ProxyMarket dalam kod anda
Ejen pengekodan
Claude CodeMembuka aplikasi desktopCodexMembuka aplikasi desktopCursorMembuka aplikasi dari webPembantu sembang
Buka dalam ChatGPTTab baharuBuka dalam ClaudeTab baharuSalin
Lihat sebagai MarkdownTeks biasa untuk alat AILihat prompt
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 Malay: https://xproxy.io/ms/document/proxymarket-vendor-integration. The Markdown copy is in English. Answer in Malay.
Aplikasi dibuka dengan prompt sudah diisi. Tiada apa-apa dijalankan sehingga anda menekan Enter.
Jual proksi atau VPN anda sendiri di ProxyMarket (market.xproxy.io). Anda terus mengendalikan pelayan anda. ProxyMarket mengendalikan kedai, menerima bayaran dan melayan pelanggan. Penyambung kecil di pihak anda menghubungkan kedua-duanya: ia membuat beberapa panggilan ke ProxyMarket dan menjawab empat webhook.
Anda perlukan: akaun vendor yang diluluskan di market.xproxy.io, pelayan yang boleh dicapai ProxyMarket melalui HTTPS dengan sijil yang sah, dan seseorang yang boleh menulis servis web kecil. Setiap endpoint, medan dan jawapan juga ada dalam rujukan API ProxyMarket.
Ringkasnya
Hantar pelan anda, pastikan stok dan kesihatan proksi sentiasa terkini, dan hantar log masuk kemudian jika perlu. Setiap panggilan membawa X-API-Key anda.
Semakan kesihatan setiap 10 minit, kemudian webhook apabila pelanggan membayar, apabila pesanan tamat dan apabila pelanggan menukar tetapan.
Bahagian anda daripada setiap jualan dikreditkan sebaik sahaja bayaran selesai. ProxyMarket mengambil 30% untuk kedai, pembayaran, sokongan dan bayaran balik.
Bagaimana ia berfungsi?
Apakah langkah untuk mula beroperasi?
Lakukan mengikut susunan ini. Langkah 1 hingga 3 menyediakan akaun anda; langkah 4 hingga 7 ialah integrasi.
- Cipta akaun biasa di market.xproxy.ioAnda
- Mohon untuk menjadi vendor (Become Vendor di menu atas)Anda
- Kelulusan, biasanya dalam masa 24 jam. Menu atas menunjukkan Vendor Pending… sehingga itu; hantar mesej kepada @xproxyio dengan e-mel akaun anda untuk mempercepatnyaProxyMarket
- Sementara itu, bina semakan kesihatan anda dan letakkan pelayan webhook anda dalam talianAnda
- Cipta kunci API anda dalam dashboard vendorAnda
- Senaraikan pelan anda, uruskan pesanan dan semak tandatangan webhookAnda
- Buat satu pesanan ujian sebenar dan semak pelanggan mendapat proksi yang berfungsiAnda + ProxyMarket
Mengapa membina semakan kesihatan dahulu?
ProxyMarket menyemak pelayan anda dengan HEAD {webhook_url}/health. Inilah satu-satunya endpoint yang menentukan sama ada pelan anda kekal dijual:
- Apabila anda mencipta kunci, ProxyMarket memanggilnya sekali. 5xx, sambungan ditolak atau lebih daripada 5 saat: tiada kunci (HTTP 422 berserta sebabnya).
- Setiap 10 minit selepas itu, selagi kunci itu mempunyai pelan yang dijual, ia memanggilnya semula. Selepas 2 kegagalan berturut-turut, setiap pelan yang dilayani oleh kunci itu disembunyikan daripada kedai dan tidak boleh dibeli. Satu jawapan yang baik mengembalikan semuanya dengan sendirinya.
| Dikira hidup | Dikira mati |
|---|---|
| Apa-apa status di bawah 500, dalam masa 5 saat. Tidak perlu log masuk atau badan. | Tamat masa, sambungan ditolak, atau apa-apa status 5xx. |
@app.route("/health", methods=["HEAD", "GET"])
def health():
return "", 200 # no login, no database, no outside callLetakkan di bawah webhook URL anda: dengan https://your-vendor-host.com/marketplace ia menjawab di /marketplace/health.
HEAD boleh mengosongkan seluruh katalog anda dalam kira-kira 20 minit. Jadikan /health laluan paling ringkas yang anda ada: tanpa log masuk, tanpa pangkalan data, tanpa panggilan luar, dan jawab GET juga. Jangan keliru dengan Laporkan kesihatan proksi anda (POST /api/integration/health). Itu panggilan yang anda buat mengenai proksi individu; ia tidak memastikan pelan anda kekal disenaraikan.
Bagaimana saya mendapatkan kunci API saya?
Anda menciptanya sendiri sebaik sahaja permohonan vendor anda diluluskan; tiada sesiapa yang menghantarnya kepada anda. Dalam dashboard vendor, berikan kunci itu nama dan webhook URL anda, contohnya https://your-vendor-host.com/marketplace. Anda juga boleh melakukannya dengan satu panggilan (rujukan):
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 nowDaripada satu kunci itu, anda mendapat dua nilai. Jangan campurkan:
| Nilai | Apa itu | Digunakan untuk |
|---|---|---|
api_key | Kunci itu sendiri, bermula dengan pm_ | Pengepala X-API-Key pada setiap panggilan yang anda buat |
signing_key | SHA256(api_key) sebagai hex 64 aksara | Menyemak X-Signature setiap webhook (caranya) |
Kunci tidak pernah tamat tempoh, dan webhook URL-nya tidak boleh ditukar kemudian: untuk berpindah pelayan, cipta kunci baharu. Jika anda mengendalikan beberapa pelayan berasingan, berikan setiap satu kunci sendiri. Pesanan pergi ke kunci yang ditetapkan dalam API Key / Server setiap pelan dalam dashboard vendor. Pelan yang dicipta melalui segerak mendapat kunci yang menyegerakkannya; pelan lama tanpa tetapan itu menghantar pesanannya ke kunci aktif anda yang paling lama.
pm-connector test memberi amaran apabila sesuatu pelan pergi ke tempat lain. Ralat: panggilan tanpa pengepala X-API-Key mendapat 422, kunci yang salah 401, dan kunci yang permohonan vendornya masih menunggu 403. Tab Integration Status dalam dashboard vendor menunjukkan, bagi setiap kunci, bila ia terakhir dilihat, versi penyambung, dan 20 penghantaran terakhir berserta keputusannya.
Bagaimana saya menyenaraikan pelan saya?
Hantar semua produk anda dengan Terbitkan atau kemas kini pelan anda apabila penyambung anda bermula, dan sekali lagi setiap kali sesuatu berubah. Pelan yang disegerakkan diluluskan serta-merta (pelan yang anda tambah secara manual dalam dashboard menunggu admin). external_id anda ialah ID anda sendiri untuk produk itu (port, modem, kolam VPN), dan setiap panggilan dan webhook selepas itu menggunakannya.
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"}]}| Perlu diketahui | Sebabnya |
|---|---|
Menghantar external_id yang sama sekali lagi mengemas kini pelan | Segerak selamat diulang; ia tidak pernah membuat pendua. |
| Pelan yang anda tinggalkan kekal dijual | Untuk berhenti menjualnya, panggil Keluarkan pelan daripada jualan. |
Gunakan hanya mobile, residential, datacenter, isp, ipv6 atau vpn sebagai proxy_type | API menerima apa-apa teks, tetapi nilai lain merosakkan pesanan: pelanggan tidak pernah mendapat log masuk. Lihat VPN dan VLESS. |
country ialah nama penuh dalam bahasa Inggeris, contohnya United States | Pelanggan menapis mengikut teks yang tepat, jadi eja dengan cara yang sama pada setiap pelan (lanjut). ProxyMarket tidak menyemaknya. |
| Pelan hanya ditunjukkan apabila ia aktif, ada stok, disenaraikan dan tidak disembunyikan oleh semakan kesihatan | stock biasanya 1 setiap port modem: satu pelanggan setiap port. |
protocol yang tidak dihantar bermaksud HTTP | Hantar juga untuk pelan VPN dan SOCKS5. |
| Pelan yang dicipta melalui segerak disematkan pada kunci yang menyegerakkannya | Pesanannya pergi ke kunci itu. Segerak tidak pernah menukar kunci pelan yang sudah wujud (lanjut). |
Apa yang berlaku apabila seseorang membeli?
- Pelanggan membayar. 70% anda dikreditkan ke baki anda serta-merta, malah sebelum pelayan anda dipanggil.
- ProxyMarket memanggil
POST {webhook_url}/provisiondenganorder_iddanexternal_plan_idanda (payload). Semak tandatangan, kemudian cipta akses pelanggan. - Anda menjawab dengan log masuk atau konfigurasi (terbaik), dengan
pending, atau denganerror. Lihat jadual di bawah. - Pelanggan melihat log masuk di ProxyMarket dan menyambung ke pelayan anda. ProxyMarket mengurangkan stok pelan sebanyak satu dengan sendirinya.
- Apabila masa tamat, ProxyMarket menamatkan pesanan dengan sendirinya (ia menyemak setiap 5 minit) dan memanggil
POST {webhook_url}/deprovision. Anda membuang akses dan meletakkan unit itu semula untuk dijual. Lihat Apabila pesanan tamat.
status yang anda jawab | Bila menggunakannya | Apa yang berlaku |
|---|---|---|
provisioned (terbaik) | Anda boleh mencipta akses serta-merta | Pelanggan mendapatnya segera. Sertakan keempat-empat proxy_ip, proxy_port, proxy_username, proxy_password, atau vpn_config_file untuk VPN. |
pending | Penyediaannya mengambil masa | Hantarkannya dengan Hantar log masuk proksi atau konfigurasi VPN. ProxyMarket menunggu 120 saat secara keseluruhan, dikira dari permulaan; selepas itu pesanan dibayar balik dan penghantaran lewat mendapat 409. |
error | Anda tidak dapat menghantar (port luar talian, tiada profil kosong) | Tiada apa-apa dihantar. Selepas 120 saat, pelanggan dibayar balik ke dompet mereka dan pendapatan anda ditolak. |
/provision menjawab dengan status lain, tamat masa (selepas 30 saat), memulangkan JSON tidak sah, atau menyatakan provisioned dengan log masuk tidak lengkap, ProxyMarket memberikan pelanggan log masuk yang anda segerakkan pada pelan sebagai ganti, jika ada. Log masuk yang dihantar tidak pernah disalin ke pelan, dan log masuk pelan yang sudah menjadi milik pesanan lain tidak digunakan semula: pesanan itu dibayar balik. Panggilan tidak dicuba semula. expires_at dalam jawapan anda diabaikan: ProxyMarket mengira masa dari pengaktifan dan memberitahu anda dalam /deprovision.
Bolehkah saya menyulitkan jawapan pada URL http:// biasa?
Ya, secara pilihan. Jawab 200 dengan pengepala X-PM-Encrypted: v1 dan X-PM-Signature: sha256= + HMAC-SHA256 hex bagi badan mentah yang dikunci dengan signing key anda, serta badan {"enc": "v1", "nonce": "…", "ct": "…"}: nonce rawak 12 bait dan teks sifer AES-256-GCM bagi jawapan biasa anda (tag dilampirkan), kedua-duanya dalam base64 standard. Kuncinya ialah HKDF-SHA256 ke atas bait UTF-8 signing key anda (salt kosong, info pm-provision-v1, 32 bait), dan AAD ialah order_id. ProxyMarket menyemak tandatangan, menyahsulit dan membaca jawapan seperti biasa; sampul yang rosak dikira seperti tamat masa. Format penuh dan vektor ujian ada dalam rujukan API dan bahagian 5.1 panduan. pm-connector melakukan ini dengan sendirinya pada URL http://. HTTPS tetap disyorkan, kerana permintaan webhook tidak disulitkan.
Simpan order_id: anda memerlukannya untuk menghantar lewat, menamatkan pesanan sendiri, dan memadankan webhook lain.
Bagaimana saya menyemak bahawa webhook benar-benar datang daripada ProxyMarket?
Setiap POST webhook membawa X-Signature: sha256=…, iaitu HMAC-SHA256 bagi badan mentah. Rahsianya ialah signing key anda, SHA256(api_key) dalam hex, bukan kunci API itu sendiri. Semaknya pada /provision, /deprovision dan /update-settings sebelum anda melakukan apa-apa lagi.
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()
...Gunakan badan permintaan mentah. Menghurai JSON dan mengeluarkannya semula mengubah bait, dan tandatangan tidak lagi sepadan.
Bagaimana saya menguji sebelum pelanggan membeli?
- Dari luar rangkaian anda, jalankan
curl -I https://your-vendor-host.com/marketplace/healthdan semak anda mendapat status di bawah 500 dalam masa 5 saat. - Segerakkan satu pelan dan cari ia di Browse di market.xproxy.io.
- Buat satu pesanan sebenar untuknya. Pelayan anda patut menerima
/provisiondengan tandatangan yang sah, dan log masuk patut muncul dalam pesanan pelanggan. - Sambung dengan log masuk itu, kemudian tunggu pesanan tamat (atau minta di Telegram untuk menamatkannya) dan semak
/deprovisionmembuang akses dan stok kembali.
Beritahu ProxyMarket di Telegram @xproxyio apabila anda membuat pesanan ujian, supaya ia boleh disemak dari pihak mereka juga.
Bagaimana saya memastikan stok dan kesihatan sentiasa terkini?
| Apabila ini berlaku di pihak anda | Panggilan |
|---|---|
| Modem atau pelayan menjadi luar talian | PATCH /plans/stock dengan stock: 0, is_active: false |
| Ia kembali dalam talian, atau port yang dijual kosong semula | PATCH /plans/stock dengan stock: 1, is_active: true |
| Harga, nama atau konfigurasi berubah | POST /plans/sync dengan pelan itu sahaja |
| Anda berhenti menjual sesuatu produk | DELETE /plans/{external_id} |
| Pilihan, setiap beberapa minit | POST /health dengan keadaan dan IP semasa setiap proksi. Sentiasa sertakan current_ip: jika tidak disertakan, IP yang disimpan akan dikosongkan. Ia tidak memastikan pelan anda kekal disenaraikan; semakan kesihatan pelayan anda yang melakukannya. |
Semua laluan bermula dengan https://market.xproxy.io/api/integration.
Apa yang berlaku apabila pesanan tamat?
ProxyMarket memanggil POST {webhook_url}/deprovision dengan reason:
| Sebab | Maksud |
|---|---|
expired | Tempoh sewa sudah tamat. Dihantar secara automatik, lewat sehingga 5 minit. |
renewed | Pelanggan membayar untuk memperbaharui pesanan yang sedang berjalan. Pesanan lama tamat sekarang dan /provision baharu dengan order_id baharu menyusul. |
cancelled | Admin membatalkan pesanan. |
admin_refund | Admin membayar balik pelanggan. Pendapatan anda untuknya ditarik balik. |
Buang log masuk pelanggan (atau matikan profil VPN mereka). Kemudian hantar bilangan sebenar unit kosong anda dengan PATCH /plans/stock: ProxyMarket mengembalikan stok dengan sendirinya selepas bayaran balik, tetapi bukan selepas tamat tempoh. Jawab {"status": "deprovisioned"}; jawapan itu hanya direkodkan dalam log.
/provision). Pesanan yang gagal disediakan dan dibayar balik secara automatik tidak menerima /deprovision langsung. Tandakan pesanan tamat tempoh hanya menukar statusnya di ProxyMarket, dalam apa-apa keadaan, walaupun yang dibatalkan. Ia tidak membayar balik pelanggan, menukar stok atau memanggil webhook anda.
Bagaimana jika pelanggan menukar whitelist IP atau cap jari TCP mereka?
Apabila pelanggan menyimpan Proxy Settings pada pesanan aktif, ProxyMarket memanggil POST {webhook_url}/update-settings. Ia dihantar sekali, untuk apa-apa jenis pesanan. Terapkan apa yang disokong oleh sistem anda dan jawab {"status": "ok"}; anda boleh mengabaikan medan yang tidak anda sokong. Badan tidak mengandungi external_plan_id, jadi cari pelan daripada order_id yang anda simpan semasa provision.
ip_whitelist: hanya IP ini boleh menggunakan proksi. Sentiasa senarai alamat tunggal;[]bermaksud tiada had IP.tcp_fingerprint: OS mana yang patut ditiru oleh sambungan (win1Windows 11,mac1macOS,ios1iPhone 15,android1Galaxy S24, dan lain-lain).nullmematikannya.
Bagaimana saya menjual VPN dan VLESS?
Aliran pesanan adalah sama; hanya apa yang anda hantar berubah. Hantar fail klien yang lengkap, tepat seperti yang patut diimport oleh pelanggan.
| Produk | Medan pelan | Anda hantar |
|---|---|---|
| OpenVPN | proxy_type: "vpn", protocol: "OpenVPN", vpn_protocol: "openvpn" | Teks .ovpn penuh, dengan sijil dan kunci di dalamnya |
| WireGuard | proxy_type: "vpn", protocol: "WireGuard", vpn_protocol: "wireguard" | .conf penuh dengan [Interface] dan [Peer] |
| VLESS (Xray) | proxy_type: "vpn", protocol: "VLESS", vpn_protocol: "vless" | Pautan vless:// satu baris, atau JSON klien Xray penuh |
proxy_type: "xray". Kedai menunjukkan pelan VLESS sebagai “Xray”, tetapi label itu datang daripada vpn_protocol. xray diterima oleh API dan kemudian merosakkan pelan: pelanggan membayar dan konfigurasi tidak pernah tiba. Tiga cara untuk menghantar fail:
- Fail yang sama untuk semua dalam pelan: letakkannya dalam
vpn_config_templatesemasa anda menyegerak. - Fail baharu setiap pesanan: buatnya dalam
/provisiondan jawab denganvpn_config_file. - Fail baharu yang mengambil masa: jawab
pending, kemudian hantarvpn_config_filedengan Hantar log masuk proksi atau konfigurasi VPN.
Untuk VLESS, berikan setiap pesanan UUID tersendiri (berkongsi satu bermakna membatalkan seorang pelanggan akan membatalkan semua), namakan transport dalam penerangan pelan (contohnya XTLS-Reality atau WS+TLS), dan buang UUID daripada inbound anda apabila pesanan tamat.
Fail OpenVPN mesti mengandungi remote, dev tun atau dev tap, atau kedua-dua client dan blok <ca>; blok <ca> sahaja akan ditolak. Setiap konfigurasi memerlukan sekurang-kurangnya 50 aksara.
Bagaimana putaran IP berfungsi?
rotation_link yang anda hantar ialah URL yang dipanggil oleh ProxyMarket sendiri, dengan GET biasa (ubah hala diikuti, sijil tidak disemak, had masa 15 saat). Ia berbuat demikian apabila pelanggan menekan Rotate dan mengikut pemasa putaran automatik yang dipilih pelanggan (setiap 5 hingga 60 minit), dan berhenti apabila pesanan tamat. Pelanggan juga melihat pautan itu dan boleh membukanya.
Jika rotation_link pelan itu sendiri diberikan sebagai sandaran (lihat di atas), ia tidak pernah pautan yang sudah menjadi milik pesanan lain.
Adakah pelayan webhook yang sudah siap?
Ya: penyambung ProxyMarket (pm-connector) berjalan pada pelayan Linux atau Windows anda dan melakukan semua yang ada di halaman ini untuk anda. Anda hanya memberikannya satu skrip kecil yang menambah dan memadam log masuk pelanggan dalam sistem anda; skrip siap dalam Python, Node.js dan shell ada di halamannya.
- Ia menjawab webhook dengan semakan tandatangan, mencipta nama pengguna dan kata laluan pelanggan dalam sistem anda, dan memadamnya apabila tempoh sewa tamat.
- Ia mencapai ProxyMarket melalui ProxyMarket hook (jenis kunci ProxyMarket hook): satu sambungan keluar ke
market-hook-service.xproxy.io, jadi pelayan tidak memerlukan port terbuka atau domain. Pelanggan sentiasa menyambung terus ke port proksi anda. - Ia mengejar ketinggalan selepas terhenti: pesanan yang tamat semasa ia luar talian kehilangan penggunanya sebaik sahaja ia kembali.
Anda membuat pelan dalam Vendor Dashboard. Jika anda mahu ProxyMarket memanggil alamat HTTPS anda sendiri dan bukannya hook, lihat menggunakan alamat anda sendiri.
Bagaimana saya dibayar?
| Bahagian anda | 70% daripada setiap jualan (kadar standard; ia boleh dipersetujui bagi setiap vendor) |
|---|---|
| Bahagian ProxyMarket | 30%, untuk kedai, pembayaran, sokongan dan bayaran balik |
| Bila ia dikreditkan | Sebaik sahaja bayaran pelanggan selesai dan pesanan menjadi aktif, sebelum /provision anda dipanggil |
| Di mana melihatnya | Earnings dalam dashboard vendor anda: setiap jualan dengan jumlahnya, jumlah anda dan kadar yang digunakan |
| Pembayaran | Dibayar oleh admin ProxyMarket daripada baki anda. Minta di Telegram apabila anda mahu mengeluarkan wang. |
| Bayaran balik | Bayaran balik automatik (tiada apa-apa dihantar dalam masa 120 saat) atau bayaran balik oleh admin menolak pendapatan itu daripada baki anda. Kod promo mengurangkan jumlah jualan, dan bahagian anda bersamanya. |
| Pengeluaran | Pembayaran boleh dibuat sehingga jumlah baki anda dan menandakan pendapatan belum dibayar yang paling lama sebagai sudah dibayar. |
Kadar disimpan bersama setiap jualan, jadi perubahan kadar kemudian tidak pernah menjejaskan wang yang telah anda peroleh.
Di mana pelan saya muncul dalam kedai?
Browse menyenaraikan pelan dengan yang paling murah dahulu, dengan satu peraturan yang perlu diketahui sebelum anda menetapkan harga: pelan daripada vendor yang menggunakan perisian XProxy didahulukan, di bawah Powered by xProxy, dengan lencana xProxy. Pelan daripada penyambung anda sendiri menyusul, di bawah Other vendors, juga yang paling murah dahulu.
| Di mana | Apa yang menentukan susunan |
|---|---|
| Browse, lalai | Kumpulan XProxy dahulu, kemudian kumpulan anda, masing-masing yang paling murah dahulu |
| Browse, apabila pelanggan mengisih | Isihan berlaku dalam setiap kumpulan, jadi pelan anda yang lebih murah tetap berada di bawah kumpulan XProxy |
| Kad “from $X” di halaman utama | Pelan XProxy paling murah bagi setiap kategori; pelan anda hanya apabila XProxy tiada stok di situ |
| Penapis negara, protokol dan carian, halaman kedai anda | Sama sepenuhnya untuk setiap vendor |
Apabila semua yang disenaraikan tergolong dalam satu kumpulan, Browse menunjukkan satu senarai rata tanpa tajuk. Kebanyakan pelanggan tiba dengan menapis negara atau protokol, dan di situ pelan anda berada di sebelah pelan semua orang.
Apakah maksud kod ralat?
| Kod | Maksud | Apa yang perlu dilakukan |
|---|---|---|
401 | Invalid API key (kunci salah atau dimatikan), Missing API key (pengepala kosong) atau Vendor inactive | Semak pengepala X-API-Key dan pastikan kunci dihidupkan dalam dashboard |
403 | Permohonan vendor anda masih menunggu (pada apa-apa panggilan), atau akaun itu bukan vendor yang diluluskan (penciptaan kunci) | Tunggu kelulusan |
404 | external_id atau order_id tidak dikenali | Semak ID; segerakkan pelan dahulu |
409 | Menghantar kelayakan kepada pesanan yang tidak lagi dibayar atau aktif | Biasanya 120 saat telah berlalu dan pesanan dibayar balik. Jangan cuba semula |
422 | Sesuatu nilai tidak sah, atau pengepala X-API-Key langsung tiada | detail dalam jawapan menamakan medan itu |
500 | Ralat ProxyMarket | Cuba semula dengan selang masa yang semakin panjang |
Ralat dikembalikan sebagai {"detail": "…"}. Tiada had kadar yang diterbitkan; segerakkan apabila ada perubahan dan bukannya dalam gelung yang ketat.
Adakah contoh penuh?
Ya. Penyambung Python ini menyegerakkan satu pelan proksi, melaporkan kesihatan setiap 5 minit dan menjawab keempat-empat webhook. Gantikan dua fungsi di bahagian atas dengan panggilan ke sistem anda sendiri, dan tambah pemasa yang menamatkan setiap pesanan apabila masanya tamat.
"""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)Di mana rujukan API penuh?
Setiap panggilan dan webhook, dengan semua medan, contoh jawapan dan kod dalam curl, Python, Node.js dan PHP, ada dalam rujukan API ProxyMarket. Fail OpenAPI 3.1 ada di market.openapi.yaml.
| Arah | Endpoint | Fungsinya |
|---|---|---|
| Anda panggil | POST /api/vendor/integrations | Cipta kunci API anda |
| Anda panggil | POST /plans/sync | Terbitkan atau kemas kini pelan |
| Anda panggil | PATCH /plans/stock | Tukar stok dan keterlihatan |
| Anda panggil | DELETE /plans/{external_id} | Keluarkan pelan daripada jualan |
| Anda panggil | POST /health | Laporkan keadaan proksi anda |
| Anda panggil | POST /orders/{order_id}/credentials | Hantar log masuk atau konfigurasi kemudian |
| Anda panggil | POST /orders/{order_id}/expire | Tandakan pesanan tamat tempoh (tiada bayaran balik) |
| Kami panggil anda | HEAD /health | Semakan kesihatan yang memastikan pelan anda kekal disenaraikan |
| Kami panggil anda | POST /provision | Pelanggan telah membayar: hantar |
| Kami panggil anda | POST /deprovision | Pesanan tamat: buang akses |
| Kami panggil anda | POST /update-settings | Terapkan whitelist IP atau cap jari TCP baharu |
| Anda panggil | GET /orders/active | Pesanan yang dibayar dan aktif yang dihalakan ke kunci anda |
Negara mana yang boleh saya senaraikan?
Mana-mana. Hantar nama penuh negara dalam bahasa Inggeris, contohnya United States, Germany atau Vietnam, dan eja dengan cara yang sama pada setiap pelan: pelanggan menapis mengikut teks yang tepat. ProxyMarket tidak menyemak nama itu; senarai dalam panduan dan dalam dashboard vendor ialah ejaan yang perlu digunakan. pm-connector test menolak nama yang tiada dalam senarai itu.
Apa yang berubah dalam versi 1.13?
- Panggilan baharu: Senaraikan pesanan yang dihalakan ke kunci anda (
GET /orders/active, denganrouted_plansdan ETag), untuk mengejar ketinggalan selepas terhenti. - Sandaran lebih selamat: log masuk yang dihantar tidak lagi disalin ke pelan, dan log masuk pelan atau pautan putaran yang menjadi milik pesanan lain tidak pernah diberikan.
- Masa provision:
/provisionhanya dihantar sebaik sahaja bayaran direkodkan, jadi penghantaran kelayakan serta-merta diterima./update-settingssentiasa membawa nilai yang baru disimpan oleh pelanggan. - Penyambung ProxyMarket: pelayan webhook yang sudah siap, termasuk cara mencapainya di belakang NAT. Lihat penyambung.
- Jawapan provision tersulit (pilihan): pada webhook URL
http://biasa, meterai jawapan/provisionanda denganX-PM-Encrypted: v1. Lihat di atas. - Penyematan pelan: pelan yang dicipta melalui segerak pergi ke kunci yang menyegerakkannya.
- Putaran: ProxyMarket memanggil
rotation_linkanda denganGET. Lihat putaran IP. - Tab Integration Status dalam dashboard vendor, dan pengepala pilihan
X-PM-Connector. - Didokumenkan mengikut kod: 422 tanpa pengepala
X-API-Key, 403 semasa permohonan anda menunggu, had masa provision 30 saat, negara dan port segerak tidak disahkan,protocollalai kepada HTTP, laporan/healthtanpacurrent_ipmengosongkannya, peraturan<ca>OpenVPN, dan tiadaexternal_plan_iddalam/update-settings.
Soalan lazim
Saya menggunakan XProxy. Adakah saya perlu membina ini?
Tidak. Hidupkan ProxyMarket dalam panel (Selling Platform → ProxyMarket) dan ia melakukan semua ini untuk anda, termasuk webhook. Lihat Jual di ProxyMarket. Pelan anda kemudian juga mendapat lencana xProxy.
Mengapa semua pelan saya hilang daripada kedai?
Hampir selalu kerana semakan kesihatan: HEAD {webhook_url}/health gagal dua kali berturut-turut (mati, lebih perlahan daripada 5 saat, 5xx, atau HEAD disekat). Betulkannya dan pelan akan kembali selepas semakan baik yang seterusnya, dalam masa 10 minit.
Saya kehilangan kunci API. Bolehkah ProxyMarket menghantarnya semula?
Tidak. Hanya hash yang disimpan. Cipta kunci baharu, dan ingat bahawa signing key turut berubah bersamanya.
Semakan tandatangan saya sentiasa gagal. Mengapa?
Biasanya salah satu daripada dua perkara: anda menggunakan kunci API mentah sebagai rahsia HMAC dan bukannya SHA256(api_key) dalam hex, atau anda menandatangani JSON yang telah dihurai dan dikodkan semula dan bukannya badan permintaan mentah.
Adakah saya dibayar jika pelayan saya gagal menghantar?
Tidak. Jika tiada apa-apa yang boleh digunakan tiba dalam masa 120 saat, pelanggan dibayar balik dan pendapatan itu ditolak daripada baki anda.
Mengapa pelanggan mendapat log masuk lama?
/provision anda menjawab dengan status selain 200, tamat masa atau menghantar JSON tidak sah, jadi ProxyMarket memberikan log masuk yang anda segerakkan pada pelan. Log masuk yang dihantar tidak pernah disimpan pada pelan, dan log masuk pelan tidak digunakan semula apabila ia sudah menjadi milik pesanan lain (pesanan itu dibayar balik sebaliknya). Sentiasa jawab 200, dengan error jika anda tidak dapat menghantar.
Bolehkah saya menyambungkan beberapa pelayan?
Ya. Cipta satu kunci bagi setiap pelayan, masing-masing dengan webhook URL tersendiri. Pelan yang dicipta melalui segerak pergi ke kunci yang menyegerakkannya; bagi pelan lama, tetapkan API Key / Server dalam dashboard, jika tidak pesanannya pergi ke kunci anda yang paling lama.
Apa yang berlaku apabila pelanggan memperbaharui?
Memperbaharui pesanan yang tamat tempoh ialah pesanan baharu biasa. Memperbaharui pesanan yang sedang berjalan mula-mula menghantar /deprovision dengan reason: renewed untuk pesanan lama, kemudian /provision untuk yang baharu, dengan order_id baharu.
Apa seterusnya?
Buka rujukan penuh, atau tanya ProxyMarket di Telegram.

