Intégration vendeur ProxyMarket : vendez vos propres proxys
Demander à l'IA
Tâche prêteCréer l'intégration ProxyMarket dans votre code
Agents de code
Claude CodeOuvre l'app de bureauCodexOuvre l'app de bureauCursorOuvre l'app depuis le webAssistants de chat
Ouvrir dans ChatGPTNouvel ongletOuvrir dans ClaudeNouvel ongletCopier
Voir en MarkdownTexte brut pour les outils d'IAVoir le 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 French: https://xproxy.io/fr/document/proxymarket-vendor-integration. The Markdown copy is in English. Answer in French.
L'app s'ouvre avec le prompt prérempli. Rien ne s'exécute tant que vous n'appuyez pas sur Entrée.
Vendez vos propres proxys ou VPN sur ProxyMarket (market.xproxy.io). Vous continuez à faire tourner vos serveurs. ProxyMarket gère la boutique, encaisse les paiements et répond aux clients. Un petit connecteur de votre côté relie les deux : il fait quelques appels à ProxyMarket et répond à quatre webhooks.
Ce qu’il vous faut : un compte vendeur validé sur market.xproxy.io, un serveur que ProxyMarket peut joindre en HTTPS avec un certificat valide, et quelqu’un capable d’écrire un petit service web. Chaque endpoint, champ et réponse figure aussi dans la référence de l’API ProxyMarket.
En bref
Envoyez vos offres, tenez à jour le stock et l’état de vos proxys, et livrez des identifiants en différé si besoin. Chaque appel porte votre X-API-Key.
Une vérification de santé toutes les 10 minutes, puis un webhook quand un client paie, quand une commande se termine et quand un client modifie un réglage.
Votre part de chaque vente est créditée dès que le paiement est confirmé. ProxyMarket garde 30 % pour la boutique, les paiements, le support et les remboursements.
Comment ça marche ?
Quelles sont les étapes pour être en vente ?
Suivez-les dans cet ordre. Les étapes 1 à 3 préparent votre compte ; les étapes 4 à 7 constituent l’intégration.
- Créez un compte normal sur market.xproxy.ioVous
- Demandez à devenir vendeur (Become Vendor dans le menu du haut)Vous
- Validation, en général sous 24 heures. Le menu du haut affiche Vendor Pending… jusque-là ; écrivez à @xproxyio avec l’e-mail de votre compte pour accélérerProxyMarket
- En attendant, créez votre vérification de santé et mettez votre serveur de webhooks en ligneVous
- Créez votre clé API dans le tableau de bord vendeurVous
- Publiez vos offres, traitez les commandes et vérifiez les signatures des webhooksVous
- Passez une vraie commande de test et vérifiez que le client reçoit un proxy fonctionnelVous + ProxyMarket
Pourquoi créer d’abord la vérification de santé ?
ProxyMarket vérifie votre serveur avec HEAD {webhook_url}/health. C’est le seul endpoint qui décide si vos offres restent en vente :
- Quand vous créez votre clé, ProxyMarket l’appelle une fois. Un 5xx, une connexion refusée ou plus de 5 secondes : pas de clé (HTTP 422 avec la raison).
- Ensuite, toutes les 10 minutes, tant que la clé a des offres en vente, il l’appelle à nouveau. Après 2 échecs de suite, toutes les offres servies par cette clé sont masquées dans la boutique et ne peuvent plus être achetées. Une seule bonne réponse les fait toutes revenir d’elles-mêmes.
| Compte comme en ligne | Compte comme hors ligne |
|---|---|
| Tout statut inférieur à 500, en moins de 5 secondes. Ni identifiants ni corps nécessaires. | Un délai dépassé, une connexion refusée ou tout statut 5xx. |
@app.route("/health", methods=["HEAD", "GET"])
def health():
return "", 200 # no login, no database, no outside callPlacez-la sous votre URL de webhook : avec https://your-vendor-host.com/marketplace, elle répond sur /marketplace/health.
HEAD peut vider tout votre catalogue en 20 minutes environ. Faites de /health votre route la plus simple : sans identifiants, sans base de données, sans appel externe, et répondez aussi à GET. Ne la confondez pas avec Signaler l’état de vos proxys (POST /api/integration/health). Celle-là est un appel que vous faites au sujet de proxys individuels ; elle ne maintient pas vos offres en vente.
Comment obtenir ma clé API ?
Vous la créez vous-même une fois votre demande de vendeur validée ; personne ne vous l’envoie. Dans le tableau de bord vendeur, donnez un nom à la clé et votre URL de webhook, par exemple https://your-vendor-host.com/marketplace. Vous pouvez aussi le faire en un appel (référence) :
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 nowCette clé vous donne deux valeurs. Ne les confondez pas :
| Valeur | Ce que c’est | Sert à |
|---|---|---|
api_key | La clé elle-même, qui commence par pm_ | L’en-tête X-API-Key de chaque appel que vous faites |
signing_key | SHA256(api_key) en hexadécimal de 64 caractères | Vérifier le X-Signature de chaque webhook (comment) |
La clé n’expire jamais, et son URL de webhook ne peut pas être modifiée ensuite : pour changer de serveur, créez une nouvelle clé. Si vous avez plusieurs serveurs indépendants, donnez à chacun sa propre clé. Les commandes vont à la clé définie dans le champ API Key / Server de chaque offre, dans le tableau de bord vendeur. Une offre créée par une synchronisation reçoit la clé qui l’a synchronisée ; une offre plus ancienne sans ce réglage envoie ses commandes à votre clé active la plus ancienne.
pm-connector test vous avertit quand une offre va ailleurs. Erreurs : un appel sans en-tête X-API-Key reçoit 422, une mauvaise clé 401, et une clé dont la demande de vendeur est encore en attente 403. L’onglet Integration Status du tableau de bord vendeur affiche, pour chaque clé, sa dernière activité, la version du connecteur et les 20 dernières livraisons avec leur résultat.
Comment publier mes offres ?
Envoyez tous vos produits avec Publier ou mettre à jour vos offres au démarrage de votre connecteur, puis à chaque changement. Les offres synchronisées sont validées immédiatement (celles ajoutées à la main dans le tableau de bord attendent un administrateur). Votre external_id est votre propre ID pour le produit (un port, un modem, un pool VPN), et tous les appels et webhooks suivants l’utilisent.
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"}]}| Bon à savoir | Pourquoi |
|---|---|
Renvoyer le même external_id met l’offre à jour | La synchronisation peut être répétée sans risque ; elle ne crée jamais de doublons. |
| Une offre que vous omettez reste en vente | Pour arrêter de la vendre, appelez Retirer une offre de la vente. |
N’utilisez que mobile, residential, datacenter, isp, ipv6 ou vpn comme proxy_type | L’API accepte n’importe quel texte, mais une autre valeur casse la commande : le client ne reçoit jamais d’identifiants. Voir VPN et VLESS. |
country est le nom complet en anglais, par exemple United States | Les clients filtrent sur le texte exact : écrivez-le de la même façon sur chaque offre (plus). ProxyMarket ne le vérifie pas. |
| Une offre n’est affichée que si elle est active, en stock, listée et non masquée par la vérification de santé | stock vaut en général 1 par port de modem : un client par port. |
protocol omis signifie HTTP | Envoyez-le quand même pour les offres VPN et SOCKS5. |
| Une offre créée par une synchronisation est rattachée à la clé qui l’a synchronisée | Ses commandes vont à cette clé. Une synchronisation ne change jamais la clé d’une offre existante (plus). |
Que se passe-t-il quand quelqu’un achète ?
- Le client paie. Vos 70 % sont crédités sur votre solde tout de suite, avant même que votre serveur soit appelé.
- ProxyMarket appelle
POST {webhook_url}/provisionavec l’order_idet votreexternal_plan_id(payload). Vérifiez la signature, puis créez l’accès du client. - Vous répondez avec les identifiants ou la config (le mieux), avec
pendingou avecerror. Voir le tableau ci-dessous. - Le client voit ses identifiants sur ProxyMarket et se connecte à votre serveur. ProxyMarket baisse lui-même le stock de l’offre d’une unité.
- Quand la durée est écoulée, ProxyMarket termine lui-même la commande (il vérifie toutes les 5 minutes) et appelle
POST {webhook_url}/deprovision. Vous retirez l’accès et remettez l’unité en vente. Voir Quand une commande se termine.
status de votre réponse | Quand l’utiliser | Ce qui se passe |
|---|---|---|
provisioned (le mieux) | Vous pouvez créer l’accès tout de suite | Le client le reçoit immédiatement. Ajoutez les quatre champs proxy_ip, proxy_port, proxy_username, proxy_password, ou vpn_config_file pour un VPN. |
pending | La mise en place prend du temps | Envoyez-le avec Livrer les identifiants du proxy ou la config VPN. ProxyMarket attend 120 secondes au total, comptées depuis le début ; ensuite la commande est remboursée et une livraison tardive reçoit 409. |
error | Vous ne pouvez pas livrer (port hors ligne, aucun profil libre) | Rien n’est livré. Après les 120 secondes, le client est remboursé sur son portefeuille et votre gain est retiré. |
/provision répond avec un autre statut, dépasse le délai (30 secondes), renvoie un JSON invalide ou indique provisioned avec des identifiants incomplets, ProxyMarket remet à la place au client les identifiants synchronisés sur l’offre, s’il y en a. Des identifiants livrés ne sont jamais copiés sur l’offre, et des identifiants d’offre qui appartiennent déjà à une autre commande ne sont pas réutilisés : cette commande est remboursée. L’appel n’est pas réessayé. Le champ expires_at de votre réponse est ignoré : ProxyMarket compte la durée à partir de l’activation et vous l’indique dans /deprovision.
Puis-je chiffrer la réponse sur une URL en http:// simple ?
Oui, en option. Répondez 200 avec les en-têtes X-PM-Encrypted: v1 et X-PM-Signature: sha256= + le HMAC-SHA256 en hexadécimal du corps brut, calculé avec votre clé de signature, et le corps {"enc": "v1", "nonce": "…", "ct": "…"} : un nonce aléatoire de 12 octets et le chiffré AES-256-GCM de votre réponse normale (tag ajouté à la fin), tous deux en base64 standard. La clé est un HKDF-SHA256 sur les octets UTF-8 de votre clé de signature (sel vide, info pm-provision-v1, 32 octets), et l’AAD est l’order_id. ProxyMarket vérifie la signature, déchiffre et lit la réponse comme d’habitude ; une enveloppe invalide compte comme un délai dépassé. Le format complet et un vecteur de test se trouvent dans la référence de l’API et la section 5.1 du guide. pm-connector le fait de lui-même sur une URL en http://. HTTPS reste recommandé, car les requêtes de webhook ne sont pas chiffrées.
Conservez l’order_id : il vous sert à livrer en différé, à terminer la commande vous-même et à faire le lien avec les autres webhooks.
Comment vérifier qu’un webhook vient vraiment de ProxyMarket ?
Chaque webhook POST porte X-Signature: sha256=…, un HMAC-SHA256 du corps brut. Le secret est votre clé de signature, SHA256(api_key) en hexadécimal, et non la clé API elle-même. Vérifiez-la sur /provision, /deprovision et /update-settings avant toute autre chose.
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()
...Utilisez le corps brut de la requête. Parser le JSON puis le resérialiser modifie les octets, et la signature ne correspond plus.
Comment tester avant que les clients achètent ?
- Depuis l’extérieur de votre réseau, lancez
curl -I https://your-vendor-host.com/marketplace/healthet vérifiez que vous obtenez un statut inférieur à 500 en moins de 5 secondes. - Synchronisez une offre et retrouvez-la dans Browse sur market.xproxy.io.
- Passez une vraie commande pour cette offre. Votre serveur doit recevoir
/provisionavec une signature valide, et les identifiants doivent apparaître dans la commande du client. - Connectez-vous avec ces identifiants, puis attendez la fin de la commande (ou demandez sur Telegram qu’on la termine) et vérifiez que
/deprovisionretire l’accès et que le stock revient.
Prévenez ProxyMarket sur Telegram @xproxyio quand vous passez la commande de test, pour qu’elle soit aussi vérifiée de leur côté.
Comment tenir à jour le stock et l’état ?
| Quand ceci se produit chez vous | Appel |
|---|---|
| Un modem ou un serveur passe hors ligne | PATCH /plans/stock avec stock: 0, is_active: false |
| Il revient en ligne, ou un port vendu est de nouveau libre | PATCH /plans/stock avec stock: 1, is_active: true |
| Un prix, un nom ou une config change | POST /plans/sync avec cette seule offre |
| Vous arrêtez de vendre un produit | DELETE /plans/{external_id} |
| Facultatif, toutes les quelques minutes | POST /health avec l’état et l’IP actuelle de chaque proxy. Incluez toujours current_ip : l’omettre efface l’IP enregistrée. Cela ne maintient pas vos offres en vente ; c’est la vérification de santé de votre serveur qui le fait. |
Tous les chemins commencent par https://market.xproxy.io/api/integration.
Que se passe-t-il quand une commande se termine ?
ProxyMarket appelle POST {webhook_url}/deprovision avec une reason :
| Raison | Signification |
|---|---|
expired | La durée de location est écoulée. Envoyé automatiquement, avec jusqu’à 5 minutes de retard. |
renewed | Le client a payé le renouvellement d’une commande en cours. L’ancienne commande se termine maintenant et un nouveau /provision avec un nouvel order_id suit. |
cancelled | Un administrateur a annulé la commande. |
admin_refund | Un administrateur a remboursé le client. Le gain correspondant vous est repris. |
Supprimez les identifiants du client (ou désactivez son profil VPN). Envoyez ensuite votre nombre réel d’unités libres avec PATCH /plans/stock : ProxyMarket remet lui-même le stock après un remboursement, mais pas après une expiration. Répondez {"status": "deprovisioned"} ; la réponse est seulement journalisée.
/provision). Une commande dont la livraison a échoué et qui a été remboursée automatiquement ne reçoit aucun /deprovision. Marquer une commande comme expirée change seulement son statut sur ProxyMarket, quel que soit son état, même annulée. Cela ne rembourse pas le client, ne change pas le stock et n’appelle pas votre webhook.
Et si un client modifie sa liste blanche d’IP ou son empreinte TCP ?
Quand un client enregistre Proxy Settings sur une commande active, ProxyMarket appelle POST {webhook_url}/update-settings. Il est envoyé une fois, pour tout type de commande. Appliquez ce que votre système prend en charge et répondez {"status": "ok"} ; vous pouvez ignorer un champ que vous ne gérez pas. Le corps ne contient pas d’external_plan_id : retrouvez l’offre à partir de l’order_id enregistré lors du provision.
ip_whitelist: seules ces IP peuvent utiliser le proxy. Toujours une liste d’adresses uniques ;[]signifie aucune limite d’IP.tcp_fingerprint: le système d’exploitation dont la connexion doit avoir l’air (win1Windows 11,mac1macOS,ios1iPhone 15,android1Galaxy S24, et d’autres).nullle désactive.
Comment vendre du VPN et du VLESS ?
Le déroulé de la commande est le même ; seul ce que vous livrez change. Envoyez le fichier client complet, exactement tel que le client doit l’importer.
| Produit | Champs de l’offre | Vous livrez |
|---|---|---|
| OpenVPN | proxy_type: "vpn", protocol: "OpenVPN", vpn_protocol: "openvpn" | Le texte .ovpn complet, certificats et clés inclus |
| WireGuard | proxy_type: "vpn", protocol: "WireGuard", vpn_protocol: "wireguard" | Le .conf complet avec [Interface] et [Peer] |
| VLESS (Xray) | proxy_type: "vpn", protocol: "VLESS", vpn_protocol: "vless" | Un lien vless:// sur une ligne, ou le JSON client Xray complet |
proxy_type: "xray". La boutique affiche les offres VLESS comme « Xray », mais ce libellé vient de vpn_protocol. xray est accepté par l’API puis casse l’offre : le client paie et la config n’arrive jamais. Trois façons de livrer le fichier :
- Le même fichier pour tous les clients de l’offre : placez-le dans
vpn_config_templatelors de la synchronisation. - Un nouveau fichier par commande : créez-le dans
/provisionet répondez avecvpn_config_file. - Un nouveau fichier qui prend du temps : répondez
pending, puis envoyezvpn_config_fileavec Livrer les identifiants du proxy ou la config VPN.
Pour VLESS, donnez à chaque commande son propre UUID (en partager un signifie que révoquer un client les révoque tous), indiquez le transport dans la description de l’offre (par exemple XTLS-Reality ou WS+TLS), et retirez l’UUID de votre inbound à la fin de la commande.
Un fichier OpenVPN doit contenir remote, dev tun ou dev tap, ou à la fois client et un bloc <ca> ; un bloc <ca> seul est refusé. Chaque config doit faire au moins 50 caractères.
Comment fonctionne la rotation d’IP ?
Le rotation_link que vous livrez est une URL que ProxyMarket appelle lui-même, avec un simple GET (redirections suivies, certificat non vérifié, délai de 15 secondes). Il le fait quand le client clique sur Rotate et selon le minuteur de rotation automatique choisi par le client (toutes les 5 à 60 minutes), et s’arrête à la fin de la commande. Le client voit aussi le lien et peut l’ouvrir.
Si le rotation_link propre à l’offre est remis en solution de repli (voir plus haut), ce n’est jamais un lien qui appartient déjà à une autre commande.
Existe-t-il un serveur de webhooks tout prêt ?
Oui : le connecteur ProxyMarket (pm-connector) tourne sur votre serveur Linux ou Windows et fait pour vous tout ce que décrit cette page. Vous lui donnez seulement un petit script qui ajoute et supprime les identifiants d’un client dans votre système ; des scripts prêts en Python, Node.js et shell sont sur sa page.
- Il répond aux webhooks en vérifiant les signatures, crée le nom d’utilisateur et le mot de passe du client dans votre système et les supprime à la fin de la location.
- Il joint ProxyMarket via le ProxyMarket hook (type de clé ProxyMarket hook) : une seule connexion sortante vers
market-hook-service.xproxy.io, donc le serveur n’a besoin ni de port ouvert ni de domaine. Les clients se connectent toujours directement au port de votre proxy. - Il rattrape le retard après une panne : les commandes terminées pendant qu’il était hors ligne perdent leur utilisateur dès son retour.
Vous créez les offres dans le Vendor Dashboard. Si vous voulez que ProxyMarket appelle votre propre adresse HTTPS au lieu du hook, voir utiliser votre propre adresse.
Comment suis-je payé ?
| Votre part | 70 % de chaque vente (le taux standard ; il peut être négocié par vendeur) |
|---|---|
| Part de ProxyMarket | 30 %, pour la boutique, les paiements, le support et les remboursements |
| Quand elle est créditée | Dès que le paiement du client est confirmé et que la commande devient active, avant l’appel de votre /provision |
| Où la voir | Earnings dans votre tableau de bord vendeur : chaque vente avec son montant, votre montant et le taux appliqué |
| Versements | Versés par l’administrateur de ProxyMarket à partir de votre solde. Demandez sur Telegram quand vous voulez retirer. |
| Remboursements | Un remboursement automatique (rien livré en 120 secondes) ou par un administrateur retire le gain de votre solde. Un code promo réduit le montant de la vente, et votre part avec. |
| Retrait | Un versement peut aller jusqu’à votre solde et marque comme payés vos gains impayés les plus anciens. |
Le taux est enregistré avec chaque vente : un changement de taux ultérieur ne touche jamais l’argent déjà gagné.
Où mes offres apparaissent-elles dans la boutique ?
Browse liste les offres de la moins chère à la plus chère, avec une règle à connaître avant de fixer vos prix : les offres des vendeurs qui utilisent le logiciel XProxy passent en premier, sous Powered by xProxy, avec un badge xProxy. Les offres de votre propre connecteur viennent ensuite, sous Other vendors, elles aussi de la moins chère à la plus chère.
| Où | Ce qui décide de l’ordre |
|---|---|
| Browse, par défaut | Le groupe XProxy d’abord, puis le vôtre, chacun de la moins chère à la plus chère |
| Browse, quand le client trie | Le tri s’applique dans chaque groupe : une offre à vous moins chère reste donc sous le groupe XProxy |
| Cartes « from $X » de la page d’accueil | L’offre XProxy la moins chère de chaque catégorie ; la vôtre seulement si XProxy n’a pas de stock dans cette catégorie |
| Filtres par pays, protocole et recherche, votre page boutique | Exactement les mêmes pour tous les vendeurs |
Quand tout ce qui est listé appartient à un seul groupe, Browse affiche une liste unique sans titres. La plupart des clients arrivent en filtrant par pays ou par protocole, et là vos offres se trouvent à côté de celles de tout le monde.
Que signifient les codes d’erreur ?
| Code | Signification | Que faire |
|---|---|---|
401 | Invalid API key (clé fausse ou désactivée), Missing API key (en-tête vide) ou Vendor inactive | Vérifiez l’en-tête X-API-Key et que la clé est activée dans le tableau de bord |
403 | Votre demande de vendeur est encore en attente (sur tout appel), ou le compte n’est pas un vendeur validé (création de clé) | Attendez la validation |
404 | external_id ou order_id inconnu | Vérifiez l’ID ; synchronisez d’abord l’offre |
409 | Livraison d’identifiants à une commande qui n’est plus payée ni active | En général, les 120 secondes sont passées et la commande a été remboursée. Ne réessayez pas |
422 | Une valeur n’est pas valide, ou l’en-tête X-API-Key est totalement absent | detail dans la réponse indique le champ |
500 | Erreur de ProxyMarket | Réessayez avec un délai croissant |
Les erreurs reviennent sous la forme {"detail": "…"}. Il n’y a pas de limite de requêtes publiée ; synchronisez à chaque changement plutôt qu’en boucle serrée.
Existe-t-il un exemple complet ?
Oui. Ce connecteur Python synchronise une offre de proxy, signale l’état toutes les 5 minutes et répond aux quatre webhooks. Remplacez les deux fonctions du haut par des appels à votre propre système, et ajoutez un minuteur qui termine chaque commande quand sa durée est écoulée.
"""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)Où se trouve la référence complète de l’API ?
Chaque appel et chaque webhook, avec tous les champs, des exemples de réponses et du code en curl, Python, Node.js et PHP, se trouvent dans la référence de l’API ProxyMarket. Le fichier OpenAPI 3.1 est disponible ici : market.openapi.yaml.
| Sens | Endpoint | Ce qu’il fait |
|---|---|---|
| Vous appelez | POST /api/vendor/integrations | Créer votre clé API |
| Vous appelez | POST /plans/sync | Publier ou mettre à jour des offres |
| Vous appelez | PATCH /plans/stock | Changer le stock et la visibilité |
| Vous appelez | DELETE /plans/{external_id} | Retirer une offre de la vente |
| Vous appelez | POST /health | Signaler l’état de vos proxys |
| Vous appelez | POST /orders/{order_id}/credentials | Livrer des identifiants ou une config en différé |
| Vous appelez | POST /orders/{order_id}/expire | Marquer une commande comme expirée (sans remboursement) |
| Nous vous appelons | HEAD /health | Vérification de santé qui maintient vos offres en vente |
| Nous vous appelons | POST /provision | Un client a payé : livrez |
| Nous vous appelons | POST /deprovision | Une commande est terminée : retirez l’accès |
| Nous vous appelons | POST /update-settings | Appliquer une nouvelle liste blanche d’IP ou empreinte TCP |
| Vous appelez | GET /orders/active | Les commandes payées et actives routées vers votre clé |
Quels pays puis-je proposer ?
Tous. Envoyez le nom complet du pays en anglais, par exemple United States, Germany ou Vietnam, et écrivez-le de la même façon sur chaque offre : les clients filtrent sur le texte exact. ProxyMarket ne vérifie pas le nom ; la liste du guide et du tableau de bord vendeur donne l’orthographe à utiliser. pm-connector test refuse un nom qui n’est pas dans cette liste.
Qu’est-ce qui a changé dans la version 1.13 ?
- Nouvel appel : Lister les commandes routées vers votre clé (
GET /orders/active, avecrouted_planset ETag), pour rattraper le retard après une panne. - Repli plus sûr : des identifiants livrés ne sont plus copiés sur l’offre, et des identifiants ou un lien de rotation d’offre qui appartiennent à une autre commande ne sont jamais remis.
- Moment du provision :
/provisionn’est envoyé qu’une fois le paiement validé, donc un envoi immédiat des identifiants est accepté./update-settingstransmet toujours les valeurs que le client vient d’enregistrer. - Connecteur ProxyMarket : un serveur de webhooks tout prêt, y compris la façon de le joindre derrière un NAT. Voir le connecteur.
- Réponse de provision chiffrée (facultatif) : sur une URL de webhook en
http://simple, scellez votre réponse/provisionavecX-PM-Encrypted: v1. Voir plus haut. - Rattachement des offres : une offre créée par une synchronisation va à la clé qui l’a synchronisée.
- Rotation : ProxyMarket appelle votre
rotation_linkavecGET. Voir Rotation d’IP. - Onglet Integration Status dans le tableau de bord vendeur, et l’en-tête facultatif
X-PM-Connector. - Documenté conformément au code : 422 sans en-tête
X-API-Key, 403 tant que votre demande est en attente, délai de 30 secondes pour le provision, pays et port de synchronisation non validés,protocolà HTTP par défaut, un rapport/healthsanscurrent_ipl’efface, la règle<ca>d’OpenVPN, et pas d’external_plan_iddans/update-settings.
FAQ
J’utilise XProxy. Dois-je développer tout ça ?
Non. Activez ProxyMarket dans le tableau de bord (Selling Platform → ProxyMarket) et il fait tout cela pour vous, webhooks compris. Voir Vendre sur ProxyMarket. Vos offres reçoivent alors aussi le badge xProxy.
Pourquoi toutes mes offres ont-elles disparu de la boutique ?
Presque toujours à cause de la vérification de santé : HEAD {webhook_url}/health a échoué deux fois de suite (serveur en panne, plus de 5 secondes, un 5xx ou HEAD bloqué). Corrigez-la et les offres reviennent après la prochaine vérification réussie, dans les 10 minutes.
J’ai perdu ma clé API. ProxyMarket peut-il me la renvoyer ?
Non. Seul un hash est stocké. Créez une nouvelle clé, et n’oubliez pas que la clé de signature change avec elle.
Ma vérification de signature échoue toujours. Pourquoi ?
En général pour l’une de deux raisons : vous avez utilisé la clé API brute comme secret HMAC au lieu de SHA256(api_key) en hexadécimal, ou vous avez signé un JSON parsé puis réencodé au lieu du corps brut de la requête.
Suis-je payé si mon serveur ne livre pas ?
Non. Si rien d’utilisable n’arrive en 120 secondes, le client est remboursé et le gain est retiré de votre solde.
Pourquoi un client a-t-il reçu d’anciens identifiants ?
Votre /provision a répondu avec un statut autre que 200, a dépassé le délai ou a envoyé un JSON invalide : ProxyMarket a donc remis les identifiants synchronisés sur l’offre. Des identifiants livrés ne sont jamais enregistrés sur l’offre, et les identifiants de l’offre ne sont pas réutilisés s’ils appartiennent déjà à une autre commande (cette commande est alors remboursée). Répondez toujours 200, avec error si vous ne pouvez pas livrer.
Puis-je connecter plusieurs serveurs ?
Oui. Créez une clé par serveur, chacune avec sa propre URL de webhook. Une offre créée par une synchronisation va à la clé qui l’a synchronisée ; pour les offres plus anciennes, réglez API Key / Server dans le tableau de bord, sinon leurs commandes vont à votre clé la plus ancienne.
Que se passe-t-il quand un client renouvelle ?
Renouveler une commande expirée est une nouvelle commande normale. Renouveler une commande en cours envoie d’abord /deprovision avec reason: renewed pour l’ancienne commande, puis /provision pour la nouvelle, avec un nouvel order_id.
Et ensuite ?
Ouvrez la référence complète, ou posez votre question à ProxyMarket sur Telegram.

