コンテンツにスキップ

ProxyMarket ベンダー連携:自分のプロキシを販売

AIに質問

用意済みタスク自分のコードにProxyMarket連携を実装する

コーディングエージェント

Claude Codeデスクトップアプリを開きますCodexデスクトップアプリを開きますCursorWebからアプリを開きます

チャットアシスタント

ChatGPTで開く新しいタブClaudeで開く新しいタブ

コピー

Markdownで表示AIツール向けのプレーンテキスト
プロンプトを見る
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 Japanese: https://xproxy.io/ja/document/proxymarket-vendor-integration. The Markdown copy is in English. Answer in Japanese.

プロンプトが入力された状態でアプリが開きます。Enterを押すまで何も実行されません。

自分のプロキシや VPN を ProxyMarket(market.xproxy.io)で販売できます。サーバーの運用はこれまでどおりあなたが行います。ショップの運営、決済、顧客対応は ProxyMarket が行います。両者をつなぐのは、あなたの側に置く小さなコネクターです。ProxyMarket をいくつか呼び出し、4 つの Webhook に応答します。

必要なもの:market.xproxy.io の承認済みベンダーアカウント、有効な証明書付きの HTTPS で ProxyMarket から接続できるサーバー、小さな Web サービスを書ける人。すべてのエンドポイント、フィールド、応答は ProxyMarket API リファレンスにも載っています。

サーバーを書く時間がない?ProxyMarket コネクターは既製のサーバーです。サーバーにインストールし、システムで顧客のログインを追加・削除する小さなスクリプトを 1 つ渡せば(Python、Node.js、シェル用を用意済み)、すべての注文を処理します。コードもポートの開放もドメインも不要です。

ひとことで言うと

あなたが ProxyMarket を呼び出す

プランを送り、在庫とプロキシの状態を最新に保ち、必要ならログインを後から届けます。すべての呼び出しに X-API-Key を付けます。

ProxyMarket があなたを呼び出す

10 分ごとのヘルスチェックに加え、顧客が支払ったとき、注文が終わったとき、顧客が設定を変更したときに Webhook を送ります。

70% があなたの取り分

各売上の取り分は、支払いが完了するとすぐに加算されます。ProxyMarket はショップ、決済、サポート、返金のために 30% を受け取ります。

仕組みは?

あなたのサーバーモデム、プロキシ、VPN
ProxyMarketショップ、決済、サポート
顧客あなたのプロキシに接続
販売するのは ProxyMarket です。あなたがプロキシのログインか VPN の設定ファイルを届けると、顧客はあなたのサーバーに直接接続します。

販売開始までの手順は?

この順番で進めてください。ステップ 1〜3 はアカウントの準備、ステップ 4〜7 は連携の作業です。

  1. market.xproxy.io で通常のアカウントを作成するあなた
  2. ベンダーに申請する(上部メニューの Become Vendor)あなた
  3. 承認。通常 24 時間以内です。それまで上部メニューには Vendor Pending… と表示されます。急ぐ場合はアカウントのメールアドレスを添えて @xproxyio に連絡してくださいProxyMarket
  4. その間にヘルスチェックを作り、Webhook サーバーをオンラインにするあなた
  5. ベンダーダッシュボードで API キーを作成するあなた
  6. プランを掲載し、注文を処理し、Webhook の署名を確認するあなた
  7. 実際のテスト注文を 1 回行い、顧客が動くプロキシを受け取れることを確認するあなた + ProxyMarket

なぜヘルスチェックを最初に作るのですか?

ProxyMarket は HEAD {webhook_url}/health でサーバーを確認します。プランが販売中のままでいられるかを決める、唯一のエンドポイントです:

  • キーを作成するとき、ProxyMarket は一度これを呼び出します。5xx、接続拒否、5 秒超のいずれかなら、キーは作成されません(理由付きの HTTP 422)。
  • その後は 10 分ごとに、キーに販売中のプランがある間は再び呼び出します。2 回続けて失敗すると、そのキーが担当するすべてのプランがショップで非表示になり、購入できなくなります。正常な応答が 1 回あれば、すべて自動で元に戻ります。
稼働中とみなされる停止中とみなされる
5 秒以内の 500 未満のステータス。ログインも本文も不要です。タイムアウト、接続拒否、または 5xx ステータス。
python
@app.route("/health", methods=["HEAD", "GET"])
def health():
    return "", 200   # no login, no database, no outside call

Webhook URL の下に置きます。https://your-vendor-host.com/marketplace なら /marketplace/health で応答します。

正常なショップが知らないうちに売れなくなる、最もよくある原因です。デプロイ、再起動、HEAD をブロックするファイアウォールで、約 20 分でカタログ全体が空になることがあります。/health は最もシンプルなルートにしてください。ログインなし、データベースなし、外部呼び出しなしで、GET にも応答させます。

プロキシの状態を報告する(POST /api/integration/health)と混同しないでください。こちらは個々のプロキシについてあなたが行う呼び出しで、プランの掲載を維持するものではありません。

API キーはどう取得しますか?

ベンダー申請が承認されたら、自分で作成します。誰かから送られてくるものではありません。ベンダーダッシュボードで、キーの名前と Webhook URL(たとえば https://your-vendor-host.com/marketplace)を入力します。1 回の呼び出しで作成することもできます(リファレンス):

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
キーは一度しか表示されません。ProxyMarket はハッシュしか保存しないので、再表示できません。すぐに保存してください。なくした場合は新しく作成してください。

この 1 つのキーから 2 つの値が得られます。混同しないでください:

値内容用途
api_keyキーそのもの。pm_ で始まりますあなたが行うすべての呼び出しの X-API-Key ヘッダー
signing_keySHA256(api_key) を 64 文字の 16 進数にしたものすべての Webhook の X-Signature の確認(方法)

キーに有効期限はなく、Webhook URL は後から変更できません。サーバーを移す場合は新しいキーを作成してください。独立したサーバーを複数運用する場合は、それぞれに専用のキーを用意します。注文は、ベンダーダッシュボードで各プランの API Key / Server に設定したキーに届きます。同期で作成したプランには同期したキーが設定されます。この設定のない古いプランの注文は、有効なキーのうち最も古いものに届きます。

2 つ目のキーを追加する場合、それ以前に作成したプランは古いキーに届き続けます。それらの API Key / Server を新しいキーに設定するか、古いキーを無効にしてください。プランの届け先が別のキーになっていると、pm-connector test が警告します。

エラー:X-API-Key ヘッダーのない呼び出しは 422、キーが間違っていれば 401、ベンダー申請がまだ審査中のキーなら 403 です。ベンダーダッシュボードの Integration Status タブには、キーごとに最終接続時刻、コネクターのバージョン、直近 20 件の配信とその結果が表示されます。

プランを掲載するには?

コネクターの起動時と、何かが変わったときに、プランの公開・更新ですべての商品を送ります。同期したプランはすぐに承認されます(ダッシュボードで手動追加したプランは管理者の承認待ちになります)。external_id は商品(ポート、モデム、VPN プール)に付ける自分用の ID で、以降のすべての呼び出しと Webhook で使われます。

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"}]}
知っておきたいこと理由
同じ external_id を再送するとプランが更新される同期は何度繰り返しても安全で、重複は作られません。
送らなかったプランは販売中のまま販売をやめるには プランを販売停止にするを呼び出します。
proxy_type には mobile、residential、datacenter、isp、ipv6、vpn だけを使うAPI はどんな文字列も受け付けますが、それ以外の値だと注文が壊れ、顧客にログインが届きません。VPN と VLESS をご覧ください。
country は英語の正式名。たとえば United States顧客は文字列の完全一致で絞り込むので、すべてのプランで同じつづりにしてください(詳しく)。ProxyMarket は確認しません。
プランが表示されるのは、有効、在庫あり、掲載中、ヘルスチェックで非表示になっていない場合だけstock は通常モデムのポート 1 つにつき 1:1 ポートに 1 人の顧客です。
protocol を省略すると HTTPVPN と SOCKS5 のプランでは必ず送ってください。
同期で作成したプランは、同期したキーに固定される注文はそのキーに届きます。既存のプランのキーが同期で変わることはありません(詳しく)。

購入されると何が起きますか?

  1. 顧客が支払います。サーバーが呼び出されるより前に、あなたの 70% がすぐに残高に加算されます。
  2. ProxyMarket が POST {webhook_url}/provision を呼び出します。order_id とあなたの external_plan_id が付いています(ペイロード)。署名を確認してから、顧客のアクセスを作成します。
  3. あなたが応答します。ログインか設定(最善)、pending、または error です。下の表をご覧ください。
  4. 顧客が ProxyMarket でログインを確認し、あなたのサーバーに接続します。ProxyMarket はプランの在庫を自動で 1 つ減らします。
  5. 期間が終わると、ProxyMarket が自動で注文を終了し(5 分ごとに確認)、POST {webhook_url}/deprovision を呼び出します。あなたはアクセスを削除し、その枠を販売に戻します。注文が終わったときをご覧ください。
応答する status使う場面どうなるか
provisioned(最善)すぐにアクセスを作成できる顧客はすぐに受け取れます。proxy_ip、proxy_port、proxy_username、proxy_password の 4 つすべて、VPN なら vpn_config_file を付けます。
pending準備に時間がかかるプロキシのログインまたは VPN 設定を届けるで送ります。ProxyMarket は開始時点から合計 120 秒待ちます。それを過ぎると注文は返金され、遅れて届けると 409 になります。
error提供できない(ポートがオフライン、空きプロファイルがない)何も届けられません。120 秒後に顧客のウォレットへ返金され、あなたの収益は差し引かれます。
エラーのときでも、必ず HTTP 200 で応答してください。/provision が他のステータスを返す、タイムアウトする(30 秒後)、不正な JSON を返す、ログインが不完全なのに provisioned と返す、のいずれかの場合、プランに同期したログインがあれば、ProxyMarket は代わりにそれを顧客に渡します。届けたログインがプランにコピーされることはなく、すでに別の注文に使われているプランのログインは再利用されません。その注文は返金されます。呼び出しの再試行はありません。

応答の expires_at は無視されます。ProxyMarket は有効化した時点から時間を数え、/deprovision で知らせます。

http:// の URL で応答を暗号化できますか?

はい、任意でできます。200 で応答し、ヘッダー X-PM-Encrypted: v1 と X-PM-Signature: sha256= + 署名キーで生の本文を HMAC-SHA256 した 16 進数を付け、本文を {"enc": "v1", "nonce": "…", "ct": "…"} にします。中身はランダムな 12 バイトの nonce と、通常の応答を AES-256-GCM で暗号化した暗号文(タグを末尾に付加)で、どちらも標準の base64 です。鍵は署名キーの UTF-8 バイト列に対する HKDF-SHA256(salt は空、info は pm-provision-v1、32 バイト)で、AAD は order_id です。ProxyMarket は署名を確認し、復号して通常どおり応答を読み取ります。不正なエンベロープはタイムアウトと同じ扱いです。完全な形式とテストベクターは API リファレンスとガイドの 5.1 節にあります。pm-connector は http:// の URL ではこれを自動で行います。Webhook のリクエスト自体は暗号化されないので、HTTPS を引き続きおすすめします。

order_id は保存してください。後からの配信、注文の手動終了、他の Webhook との照合に必要です。

Webhook が本当に ProxyMarket から来たか確認するには?

すべての Webhook POST には、生の本文の HMAC-SHA256 である X-Signature: sha256=… が付いています。秘密鍵は API キーそのものではなく、署名キー(SHA256(api_key) の 16 進数)です。/provision、/deprovision、/update-settings では、何よりも先にこれを確認してください。

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()
    ...

生のリクエスト本文を使ってください。JSON をパースして再び出力するとバイト列が変わり、署名が一致しなくなります。

顧客が購入する前にテストするには?

  1. ネットワークの外から curl -I https://your-vendor-host.com/marketplace/health を実行し、5 秒以内に 500 未満のステータスが返ることを確認します。
  2. プランを 1 つ同期し、market.xproxy.io の Browse で見つけます。
  3. そのプランを実際に 1 回注文します。サーバーに有効な署名付きの /provision が届き、顧客の注文にログインが表示されるはずです。
  4. そのログインで接続し、注文が終わるのを待ち(または Telegram で終了を依頼し)、/deprovision でアクセスが削除され、在庫が戻ることを確認します。

テスト注文を行うときは Telegram @xproxyio で ProxyMarket に知らせてください。ProxyMarket 側からも確認できます。

在庫と状態を最新に保つには?

あなたの側で起きたこと呼び出し
モデムやサーバーがオフラインになったPATCH /plans/stock に stock: 0, is_active: false
オンラインに戻った、または売れたポートが再び空いたPATCH /plans/stock に stock: 1, is_active: true
価格、名前、設定が変わったPOST /plans/sync にそのプランだけ
商品の販売をやめるDELETE /plans/{external_id}
任意、数分ごとPOST /health に各プロキシの状態と現在の IP。current_ip は必ず含めてください。省略すると保存された IP が消去されます。これでプランの掲載は維持されません。維持するのはサーバーのヘルスチェックです。

パスはすべて https://market.xproxy.io/api/integration から始まります。

注文が終わると何が起きますか?

ProxyMarket が reason を付けて POST {webhook_url}/deprovision を呼び出します:

理由意味
expiredレンタル期間が終わりました。自動で送られ、最大 5 分遅れます。
renewed顧客が稼働中の注文の更新を支払いました。古い注文はここで終わり、新しい order_id で新しい /provision が続きます。
cancelled管理者が注文をキャンセルしました。
admin_refund管理者が顧客に返金しました。その分の収益は差し戻されます。

顧客のログインを削除します(または VPN プロファイルを無効にします)。次に PATCH /plans/stock で実際の空き数を送ります。返金後は ProxyMarket が自動で在庫を戻しますが、期限切れの後は戻しません。{"status": "deprovisioned"} で応答します。応答はログに記録されるだけです。

この呼び出しは一度だけ送られ、再試行されません。その時点でサーバーが停止していると、顧客はアクセスを持ったままになります。期間が来たら、自分のタイマーでも各注文を終了してください(期間は /provision でわかります)。提供に失敗して自動返金された注文には、/deprovision は一切送られません。

注文を期限切れにするは、ProxyMarket 上のステータスを変えるだけです。キャンセル済みを含め、どの状態でも使えます。顧客への返金、在庫の変更、Webhook の呼び出しは行いません。

顧客が IP ホワイトリストや TCP フィンガープリントを変更したら?

顧客が有効な注文で Proxy Settings を保存すると、ProxyMarket が POST {webhook_url}/update-settings を呼び出します。注文の種類を問わず、一度だけ送られます。システムが対応しているものを適用し、{"status": "ok"} で応答します。対応していないフィールドは無視してかまいません。本文に external_plan_id はないので、provision の時点で保存した order_id からプランを特定してください。

  • ip_whitelist:プロキシを使える IP。常に単一アドレスのリストです。[] は IP 制限なしを意味します。
  • tcp_fingerprint:接続をどの OS に見せるか(win1 Windows 11、mac1 macOS、ios1 iPhone 15、android1 Galaxy S24 など)。null で無効になります。

VPN と VLESS を販売するには?

注文の流れは同じで、届けるものだけが変わります。顧客がそのまま読み込める完全なクライアントファイルを送ってください。

商品プランのフィールド届けるもの
OpenVPNproxy_type: "vpn"、protocol: "OpenVPN"、vpn_protocol: "openvpn"証明書と鍵を含む .ovpn の全文
WireGuardproxy_type: "vpn"、protocol: "WireGuard"、vpn_protocol: "wireguard"[Interface] と [Peer] を含む完全な .conf
VLESS (Xray)proxy_type: "vpn"、protocol: "VLESS"、vpn_protocol: "vless"1 行の vless:// リンク、または完全な Xray クライアント JSON
proxy_type: "xray" は絶対に送らないでください。ショップでは VLESS プランが「Xray」と表示されますが、この表示は vpn_protocol から来ています。xray は API に受け付けられた後でプランを壊し、顧客が支払っても設定が届きません。

ファイルの届け方は 3 つあります:

  • プランの全員に同じファイル:同期時に vpn_config_template に入れます。
  • 注文ごとに新しいファイル:/provision で作成し、vpn_config_file で応答します。
  • 作成に時間がかかる新しいファイル:pending で応答し、プロキシのログインまたは VPN 設定を届けるで vpn_config_file を送ります。

VLESS では、注文ごとに専用の UUID を発行し(共有すると、1 人を無効にしたときに全員が無効になります)、プランの説明にトランスポート(たとえば XTLS-Reality や WS+TLS)を書き、注文が終わったらインバウンドから UUID を削除してください。

OpenVPN のファイルには remote、dev tun か dev tap、または client と <ca> ブロックの両方が必要です。<ca> ブロックだけでは拒否されます。どの設定も 50 文字以上必要です。

IP ローテーションの仕組みは?

あなたが届ける rotation_link は、ProxyMarket 自身が呼び出す URL で、単純な GET を使います(リダイレクトに従い、証明書は確認せず、タイムアウトは 15 秒)。顧客が Rotate を押したときと、顧客が選んだ自動ローテーションのタイマー(5〜60 分ごと)で呼び出し、注文が終わると止めます。顧客にもリンクが表示され、開くことができます。

プラン自体の rotation_link が代わりに渡される場合(上記参照)も、すでに別の注文に使われているものが渡されることはありません。

既製の Webhook サーバーはありますか?

はい。ProxyMarket コネクター(pm-connector)は Linux や Windows のサーバーで動き、このページの内容をすべて代わりに行います。渡すのは、システムで顧客のログインを追加・削除する小さなスクリプト 1 つだけです。Python、Node.js、シェル用のスクリプトはそのページにあります。

  • 署名を確認して Webhook に応答し、システムに顧客のユーザー名とパスワードを作成し、レンタルが終わると削除します。
  • ProxyMarket hook(キーのタイプ ProxyMarket hook)を通じて ProxyMarket に接続します。market-hook-service.xproxy.io への外向き接続 1 本なので、サーバーにポートの開放もドメインも不要です。顧客は常にあなたのプロキシのポートに直接接続します。
  • 停止後に追いつきます。オフラインの間に終わった注文のユーザーは、復帰するとすぐに削除されます。

プランは Vendor Dashboard で作成します。hook の代わりに自分の HTTPS アドレスを ProxyMarket に呼び出させたい場合は、自分のアドレスを使うをご覧ください。

報酬はどう受け取りますか?

あなたの取り分各売上の 70%(標準レート。ベンダーごとに個別に合意できます)
ProxyMarket の取り分30%。ショップ、決済、サポート、返金のため
加算されるタイミング顧客の支払いが完了して注文が有効になった時点。/provision が呼び出される前です
確認する場所ベンダーダッシュボードの Earnings:各売上の金額、あなたの金額、適用されたレート
支払いProxyMarket の管理者が残高から支払います。出金したいときは Telegram で連絡してください。
返金自動返金(120 秒以内に何も届かなかった)または管理者による返金があると、その収益は残高から差し引かれます。プロモコードを使うと売上額が下がり、取り分もそれに応じて下がります。
出金残高までの金額を出金でき、未払いの収益のうち古いものから支払い済みになります。

レートは売上ごとに保存されるので、後でレートが変わっても、すでに得た収益には影響しません。

ショップのどこにプランが表示されますか?

Browse はプランを安い順に並べますが、価格を決める前に知っておきたいルールが 1 つあります。XProxy ソフトを使うベンダーのプランが先に表示され、Powered by xProxy の下に xProxy バッジ付きで並びます。あなたのコネクターのプランはその次の Other vendors の下に、同じく安い順で並びます。

場所並び順を決めるもの
Browse(デフォルト)XProxy グループが先、次にあなたのグループ。それぞれ安い順
Browse(顧客が並べ替えたとき)並べ替えは各グループの中で適用されるので、あなたのプランが安くても XProxy グループの下に表示されます
ホームページの「from $X」カード各カテゴリで最も安い XProxy プラン。XProxy に在庫がないときだけあなたのプラン
国・プロトコル・検索のフィルター、あなたのストアページすべてのベンダーでまったく同じ

掲載されているものがすべて 1 つのグループの場合、Browse は見出しのない 1 つのリストで表示します。ほとんどの顧客は国やプロトコルで絞り込んで来るので、そこではあなたのプランも他のベンダーと並んで表示されます。

エラーコードの意味は?

コード意味やること
401Invalid API key(キーが間違っているか無効)、Missing API key(ヘッダーが空)、または Vendor inactiveX-API-Key ヘッダーと、ダッシュボードでキーが有効かを確認してください
403ベンダー申請がまだ審査中(すべての呼び出し)、またはアカウントが承認済みベンダーではない(キー作成時)承認を待ってください
404不明な external_id または order_idID を確認し、先にプランを同期してください
409支払い済みでも有効でもなくなった注文に認証情報を届けようとしたたいていは 120 秒が過ぎて注文が返金されています。再試行しないでください
422値が不正、または X-API-Key ヘッダーがまったくない応答の detail にフィールド名が書かれています
500ProxyMarket のエラー間隔を少しずつ広げて再試行してください

エラーは {"detail": "…"} の形で返ります。公開されたレート制限はありませんが、短いループで繰り返さず、変更があったときに同期してください。

完全な例はありますか?

はい。この Python のコネクターは、プロキシのプランを 1 つ同期し、5 分ごとに状態を報告し、4 つの Webhook すべてに応答します。上部の 2 つの関数を自分のシステムの呼び出しに置き換え、期間が来たら各注文を終了するタイマーを追加してください。

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)

完全な API リファレンスはどこですか?

すべての呼び出しと Webhook は、全フィールド、応答例、curl・Python・Node.js・PHP のコードとともに ProxyMarket API リファレンスに載っています。OpenAPI 3.1 のファイルは market.openapi.yaml です。

方向エンドポイント内容
あなたが呼び出すPOST /api/vendor/integrationsAPI キーを作成する
あなたが呼び出すPOST /plans/syncプランを公開・更新する
あなたが呼び出すPATCH /plans/stock在庫と表示を変更する
あなたが呼び出すDELETE /plans/{external_id}プランを販売停止にする
あなたが呼び出すPOST /healthプロキシの状態を報告する
あなたが呼び出すPOST /orders/{order_id}/credentialsログインや設定を後から届ける
あなたが呼び出すPOST /orders/{order_id}/expire注文を期限切れにする(返金なし)
こちらから呼び出すHEAD /healthプランの掲載を維持するヘルスチェック
こちらから呼び出すPOST /provision顧客が支払った:提供する
こちらから呼び出すPOST /deprovision注文が終わった:アクセスを削除する
こちらから呼び出すPOST /update-settings新しい IP ホワイトリストや TCP フィンガープリントを適用する
あなたが呼び出すGET /orders/activeあなたのキーに届く支払い済み・有効な注文

どの国を掲載できますか?

どの国でもかまいません。英語の正式な国名(たとえば United States、Germany、Vietnam)を送り、すべてのプランで同じつづりにしてください。顧客は文字列の完全一致で絞り込みます。ProxyMarket は国名を確認しません。ガイドとベンダーダッシュボードにある一覧のつづりを使ってください。pm-connector test は一覧にない国名を拒否します。

バージョン 1.13 の変更点は?

  • 新しい呼び出し:キーに届く注文の一覧(GET /orders/active、routed_plans と ETag 付き)。停止後に追いつくためのものです。
  • より安全なフォールバック:届けたログインがプランにコピーされなくなり、別の注文に使われているプランのログインやローテーションリンクが渡されることはなくなりました。
  • provision のタイミング:/provision は支払いが確定してから送られるので、すぐに認証情報を送っても受け付けられます。/update-settings には常に顧客が保存したばかりの値が入ります。
  • ProxyMarket コネクター:既製の Webhook サーバー。NAT の内側から接続する方法も含みます。コネクターをご覧ください。
  • 暗号化された provision の応答(任意):http:// の Webhook URL では、X-PM-Encrypted: v1 で /provision の応答を暗号化できます。上記をご覧ください。
  • プランの固定:同期で作成したプランは、同期したキーに届きます。
  • ローテーション:ProxyMarket は rotation_link を GET で呼び出します。IP ローテーションをご覧ください。
  • ベンダーダッシュボードの Integration Status タブと、任意の X-PM-Connector ヘッダー。
  • コードに合わせて明記:X-API-Key ヘッダーなしで 422、申請の審査中は 403、provision のタイムアウトは 30 秒、国と同期ポートは検証されない、protocol のデフォルトは HTTP、current_ip のない /health 報告はそれを消去する、OpenVPN の <ca> ルール、/update-settings に external_plan_id はない。

よくある質問

XProxy を使っています。これを作る必要はありますか?

いいえ。パネル(Selling Platform → ProxyMarket)で ProxyMarket をオンにすれば、Webhook も含めてすべて自動で行われます。ProxyMarket で販売するをご覧ください。その場合、プランには xProxy バッジも付きます。

なぜプランがすべてショップから消えたのですか?

ほとんどの場合、ヘルスチェックです。HEAD {webhook_url}/health が 2 回続けて失敗しました(停止、5 秒より遅い、5xx、または HEAD がブロックされている)。直せば、次に正常な確認があった後、10 分以内にプランは戻ります。

API キーをなくしました。ProxyMarket から再送してもらえますか?

いいえ。保存されているのはハッシュだけです。新しいキーを作成してください。署名キーも一緒に変わる点に注意してください。

署名の確認がいつも失敗します。なぜですか?

たいていは次の 2 つのどちらかです。HMAC の秘密鍵に SHA256(api_key) の 16 進数ではなく生の API キーを使っている、または生のリクエスト本文ではなく、パースして再エンコードした JSON に署名している。

サーバーが提供に失敗しても報酬はもらえますか?

いいえ。120 秒以内に使えるものが届かなければ、顧客に返金され、その収益は残高から差し引かれます。

なぜ顧客に古いログインが渡されたのですか?

/provision が 200 以外のステータスを返した、タイムアウトした、または不正な JSON を送ったため、ProxyMarket がプランに同期したログインを渡しました。届けたログインがプランに保存されることはなく、プランのログインがすでに別の注文に使われている場合は再利用されません(代わりにその注文は返金されます)。提供できない場合も error を付けて、必ず 200 で応答してください。

複数のサーバーを接続できますか?

はい。サーバーごとに、それぞれ専用の Webhook URL を持つキーを 1 つ作成します。同期で作成したプランは、同期したキーに届きます。古いプランはダッシュボードで API Key / Server を設定してください。設定しないと、注文は最も古いキーに届きます。

顧客が更新すると何が起きますか?

期限切れの注文の更新は、通常の新しい注文です。稼働中の注文を更新すると、まず古い注文に reason: renewed 付きの /deprovision が送られ、次に新しい order_id で新しい注文の /provision が送られます。

次はどうする?

完全なリファレンスを開くか、Telegram で ProxyMarket に問い合わせてください。

解決しませんか?技術者がワンタイム PIN でお使いのデバイスを確認できます。Telegram でチャットすることもできます。