Langkau ke kandungan

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 web

Pembantu sembang

Buka dalam ChatGPTTab baharuBuka dalam ClaudeTab baharu

Salin

Lihat sebagai MarkdownTeks biasa untuk alat AI
Lihat 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.

Tiada masa untuk menulis pelayan? Penyambung ProxyMarket ialah pelayan yang sudah siap. Pasangkannya pada pelayan anda, berikan satu skrip kecil yang menambah dan memadam log masuk pelanggan dalam sistem anda (skrip siap dalam Python, Node.js dan shell), dan ia menghantar setiap pesanan. Tanpa kod, tanpa port terbuka, tanpa domain.

Ringkasnya

Anda memanggil ProxyMarket

Hantar pelan anda, pastikan stok dan kesihatan proksi sentiasa terkini, dan hantar log masuk kemudian jika perlu. Setiap panggilan membawa X-API-Key anda.

ProxyMarket memanggil anda

Semakan kesihatan setiap 10 minit, kemudian webhook apabila pelanggan membayar, apabila pesanan tamat dan apabila pelanggan menukar tetapan.

Anda mendapat 70%

Bahagian anda daripada setiap jualan dikreditkan sebaik sahaja bayaran selesai. ProxyMarket mengambil 30% untuk kedai, pembayaran, sokongan dan bayaran balik.

Bagaimana ia berfungsi?

Pelayan andamodem, proksi, VPN
ProxyMarketkedai, pembayaran, sokongan
Pelangganmenyambung ke proksi anda
ProxyMarket menjual. Anda menghantar log masuk proksi atau fail konfigurasi VPN, dan pelanggan kemudian menyambung terus ke pelayan anda.

Apakah langkah untuk mula beroperasi?

Lakukan mengikut susunan ini. Langkah 1 hingga 3 menyediakan akaun anda; langkah 4 hingga 7 ialah integrasi.

  1. Cipta akaun biasa di market.xproxy.ioAnda
  2. Mohon untuk menjadi vendor (Become Vendor di menu atas)Anda
  3. Kelulusan, biasanya dalam masa 24 jam. Menu atas menunjukkan Vendor Pending… sehingga itu; hantar mesej kepada @xproxyio dengan e-mel akaun anda untuk mempercepatnyaProxyMarket
  4. Sementara itu, bina semakan kesihatan anda dan letakkan pelayan webhook anda dalam talianAnda
  5. Cipta kunci API anda dalam dashboard vendorAnda
  6. Senaraikan pelan anda, uruskan pesanan dan semak tandatangan webhookAnda
  7. 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 hidupDikira 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.
python
@app.route("/health", methods=["HEAD", "GET"])
def health():
    return "", 200   # no login, no database, no outside call

Letakkan di bawah webhook URL anda: dengan https://your-vendor-host.com/marketplace ia menjawab di /marketplace/health.

Inilah punca paling biasa kedai yang berfungsi tiba-tiba berhenti menjual tanpa disedari. Satu deploy, mula semula, atau firewall yang menyekat 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):

bash
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 now
Kunci ditunjukkan sekali sahaja. ProxyMarket hanya menyimpan hash dan tidak boleh memberikannya semula. Simpan dengan segera. Jika hilang, cipta yang baharu.

Daripada satu kunci itu, anda mendapat dua nilai. Jangan campurkan:

NilaiApa ituDigunakan untuk
api_keyKunci itu sendiri, bermula dengan pm_Pengepala X-API-Key pada setiap panggilan yang anda buat
signing_keySHA256(api_key) sebagai hex 64 aksaraMenyemak 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.

Menambah kunci kedua? Pelan yang dibuat sebelum itu terus pergi ke kunci lama. Tetapkan API Key / Server pelan tersebut kepada kunci baharu, atau matikan kunci 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.

bash
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 diketahuiSebabnya
Menghantar external_id yang sama sekali lagi mengemas kini pelanSegerak selamat diulang; ia tidak pernah membuat pendua.
Pelan yang anda tinggalkan kekal dijualUntuk berhenti menjualnya, panggil Keluarkan pelan daripada jualan.
Gunakan hanya mobile, residential, datacenter, isp, ipv6 atau vpn sebagai proxy_typeAPI 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 StatesPelanggan 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 kesihatanstock biasanya 1 setiap port modem: satu pelanggan setiap port.
protocol yang tidak dihantar bermaksud HTTPHantar juga untuk pelan VPN dan SOCKS5.
Pelan yang dicipta melalui segerak disematkan pada kunci yang menyegerakkannyaPesanannya pergi ke kunci itu. Segerak tidak pernah menukar kunci pelan yang sudah wujud (lanjut).

Apa yang berlaku apabila seseorang membeli?

  1. Pelanggan membayar. 70% anda dikreditkan ke baki anda serta-merta, malah sebelum pelayan anda dipanggil.
  2. ProxyMarket memanggil POST {webhook_url}/provision dengan order_id dan external_plan_id anda (payload). Semak tandatangan, kemudian cipta akses pelanggan.
  3. Anda menjawab dengan log masuk atau konfigurasi (terbaik), dengan pending, atau dengan error. Lihat jadual di bawah.
  4. Pelanggan melihat log masuk di ProxyMarket dan menyambung ke pelayan anda. ProxyMarket mengurangkan stok pelan sebanyak satu dengan sendirinya.
  5. 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 jawabBila menggunakannyaApa yang berlaku
provisioned (terbaik)Anda boleh mencipta akses serta-mertaPelanggan mendapatnya segera. Sertakan keempat-empat proxy_ip, proxy_port, proxy_username, proxy_password, atau vpn_config_file untuk VPN.
pendingPenyediaannya mengambil masaHantarkannya 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.
errorAnda 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.
Sentiasa jawab HTTP 200, walaupun untuk ralat. Jika /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.

python
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?

  1. Dari luar rangkaian anda, jalankan curl -I https://your-vendor-host.com/marketplace/health dan semak anda mendapat status di bawah 500 dalam masa 5 saat.
  2. Segerakkan satu pelan dan cari ia di Browse di market.xproxy.io.
  3. Buat satu pesanan sebenar untuknya. Pelayan anda patut menerima /provision dengan tandatangan yang sah, dan log masuk patut muncul dalam pesanan pelanggan.
  4. Sambung dengan log masuk itu, kemudian tunggu pesanan tamat (atau minta di Telegram untuk menamatkannya) dan semak /deprovision membuang 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 andaPanggilan
Modem atau pelayan menjadi luar talianPATCH /plans/stock dengan stock: 0, is_active: false
Ia kembali dalam talian, atau port yang dijual kosong semulaPATCH /plans/stock dengan stock: 1, is_active: true
Harga, nama atau konfigurasi berubahPOST /plans/sync dengan pelan itu sahaja
Anda berhenti menjual sesuatu produkDELETE /plans/{external_id}
Pilihan, setiap beberapa minitPOST /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:

SebabMaksud
expiredTempoh sewa sudah tamat. Dihantar secara automatik, lewat sehingga 5 minit.
renewedPelanggan membayar untuk memperbaharui pesanan yang sedang berjalan. Pesanan lama tamat sekarang dan /provision baharu dengan order_id baharu menyusul.
cancelledAdmin membatalkan pesanan.
admin_refundAdmin 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.

Panggilan ini dihantar sekali dan tidak pernah dicuba semula. Jika pelayan anda mati pada masa itu, pelanggan kekal mempunyai akses. Tamatkan juga setiap pesanan menggunakan pemasa anda sendiri apabila masanya tamat (anda tahu tempohnya daripada /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 (win1 Windows 11, mac1 macOS, ios1 iPhone 15, android1 Galaxy S24, dan lain-lain). null mematikannya.

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.

ProdukMedan pelanAnda hantar
OpenVPNproxy_type: "vpn", protocol: "OpenVPN", vpn_protocol: "openvpn"Teks .ovpn penuh, dengan sijil dan kunci di dalamnya
WireGuardproxy_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
Jangan sekali-kali hantar 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_template semasa anda menyegerak.
  • Fail baharu setiap pesanan: buatnya dalam /provision dan jawab dengan vpn_config_file.
  • Fail baharu yang mengambil masa: jawab pending, kemudian hantar vpn_config_file dengan 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 anda70% daripada setiap jualan (kadar standard; ia boleh dipersetujui bagi setiap vendor)
Bahagian ProxyMarket30%, untuk kedai, pembayaran, sokongan dan bayaran balik
Bila ia dikreditkanSebaik sahaja bayaran pelanggan selesai dan pesanan menjadi aktif, sebelum /provision anda dipanggil
Di mana melihatnyaEarnings dalam dashboard vendor anda: setiap jualan dengan jumlahnya, jumlah anda dan kadar yang digunakan
PembayaranDibayar oleh admin ProxyMarket daripada baki anda. Minta di Telegram apabila anda mahu mengeluarkan wang.
Bayaran balikBayaran 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.
PengeluaranPembayaran 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 manaApa yang menentukan susunan
Browse, lalaiKumpulan XProxy dahulu, kemudian kumpulan anda, masing-masing yang paling murah dahulu
Browse, apabila pelanggan mengisihIsihan berlaku dalam setiap kumpulan, jadi pelan anda yang lebih murah tetap berada di bawah kumpulan XProxy
Kad “from $X” di halaman utamaPelan XProxy paling murah bagi setiap kategori; pelan anda hanya apabila XProxy tiada stok di situ
Penapis negara, protokol dan carian, halaman kedai andaSama 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?

KodMaksudApa yang perlu dilakukan
401Invalid API key (kunci salah atau dimatikan), Missing API key (pengepala kosong) atau Vendor inactiveSemak pengepala X-API-Key dan pastikan kunci dihidupkan dalam dashboard
403Permohonan vendor anda masih menunggu (pada apa-apa panggilan), atau akaun itu bukan vendor yang diluluskan (penciptaan kunci)Tunggu kelulusan
404external_id atau order_id tidak dikenaliSemak ID; segerakkan pelan dahulu
409Menghantar kelayakan kepada pesanan yang tidak lagi dibayar atau aktifBiasanya 120 saat telah berlalu dan pesanan dibayar balik. Jangan cuba semula
422Sesuatu nilai tidak sah, atau pengepala X-API-Key langsung tiadadetail dalam jawapan menamakan medan itu
500Ralat ProxyMarketCuba 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.

python
"""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.

ArahEndpointFungsinya
Anda panggilPOST /api/vendor/integrationsCipta kunci API anda
Anda panggilPOST /plans/syncTerbitkan atau kemas kini pelan
Anda panggilPATCH /plans/stockTukar stok dan keterlihatan
Anda panggilDELETE /plans/{external_id}Keluarkan pelan daripada jualan
Anda panggilPOST /healthLaporkan keadaan proksi anda
Anda panggilPOST /orders/{order_id}/credentialsHantar log masuk atau konfigurasi kemudian
Anda panggilPOST /orders/{order_id}/expireTandakan pesanan tamat tempoh (tiada bayaran balik)
Kami panggil andaHEAD /healthSemakan kesihatan yang memastikan pelan anda kekal disenaraikan
Kami panggil andaPOST /provisionPelanggan telah membayar: hantar
Kami panggil andaPOST /deprovisionPesanan tamat: buang akses
Kami panggil andaPOST /update-settingsTerapkan whitelist IP atau cap jari TCP baharu
Anda panggilGET /orders/activePesanan 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, dengan routed_plans dan 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: /provision hanya dihantar sebaik sahaja bayaran direkodkan, jadi penghantaran kelayakan serta-merta diterima. /update-settings sentiasa 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 /provision anda dengan X-PM-Encrypted: v1. Lihat di atas.
  • Penyematan pelan: pelan yang dicipta melalui segerak pergi ke kunci yang menyegerakkannya.
  • Putaran: ProxyMarket memanggil rotation_link anda dengan GET. 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, protocol lalai kepada HTTP, laporan /health tanpa current_ip mengosongkannya, peraturan <ca> OpenVPN, dan tiada external_plan_id dalam /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.

Masih buntu?Juruteknik boleh menyemak peranti anda dengan PIN sekali guna, atau berbual dengan kami di Telegram.