Przejdź do głównej zawartości

Integracja sprzedawcy ProxyMarket: sprzedawaj własne proxy

Zapytaj AI

Gotowe zadanieZbuduj integrację z ProxyMarket w swoim kodzie

Agenci kodujący

Claude CodeOtwiera aplikację desktopowąCodexOtwiera aplikację desktopowąCursorOtwiera aplikację w przeglądarce

Asystenci czatu

Otwórz w ChatGPTNowa kartaOtwórz w ClaudeNowa karta

Kopiuj

Pokaż jako MarkdownCzysty tekst dla narzędzi AI
Zobacz 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 Polish: https://xproxy.io/pl/document/proxymarket-vendor-integration. The Markdown copy is in English. Answer in Polish.

Aplikacja otworzy się z wypełnionym promptem. Nic się nie uruchomi, dopóki nie naciśniesz Enter.

Sprzedawaj własne proxy lub VPN na ProxyMarket (market.xproxy.io). Nadal sam utrzymujesz swoje serwery. ProxyMarket prowadzi sklep, przyjmuje płatności i odpowiada klientom. Mały konektor po Twojej stronie łączy jedno z drugim: wykonuje kilka wywołań do ProxyMarket i odpowiada na cztery webhooki.

Będziesz potrzebować: zatwierdzonego konta sprzedawcy na market.xproxy.io, serwera, z którym ProxyMarket może się połączyć przez HTTPS z ważnym certyfikatem, oraz kogoś, kto napisze małą usługę webową. Każdy endpoint, pole i odpowiedź znajdziesz też w dokumentacji API ProxyMarket.

Nie masz czasu pisać serwera? Konektor ProxyMarket to gotowe rozwiązanie. Zainstaluj go na swoim serwerze, daj mu jeden mały skrypt, który dodaje i usuwa dane logowania klienta w Twoim systemie (gotowe skrypty w Pythonie, Node.js i shellu), a dostarczy każde zamówienie. Bez kodu, bez otwartego portu, bez domeny.

W skrócie

Ty wywołujesz ProxyMarket

Wysyłasz plany, aktualizujesz dostępność i stan proxy oraz w razie potrzeby dostarczasz dane logowania z opóźnieniem. Każde wywołanie zawiera Twój X-API-Key.

ProxyMarket wywołuje Ciebie

Sprawdzanie stanu co 10 minut, a do tego webhook, gdy klient zapłaci, gdy zamówienie się skończy i gdy klient zmieni ustawienie.

Zachowujesz 70%

Twój udział w każdej sprzedaży jest naliczany, gdy tylko płatność zostanie zaksięgowana. ProxyMarket zatrzymuje 30% za sklep, płatności, wsparcie i zwroty.

Jak to działa?

Twój serwermodemy, proxy, VPN
ProxyMarketsklep, płatności, wsparcie
Klientłączy się z Twoim proxy
ProxyMarket sprzedaje. Ty dostarczasz dane logowania do proxy lub plik konfiguracyjny VPN, a klient łączy się bezpośrednio z Twoim serwerem.

Jakie są kroki do uruchomienia sprzedaży?

Wykonaj je w tej kolejności. Kroki 1–3 to konfiguracja konta; kroki 4–7 to integracja.

  1. Załóż zwykłe konto na market.xproxy.ioTy
  2. Złóż wniosek o status sprzedawcy (Become Vendor w górnym menu)Ty
  3. Zatwierdzenie, zwykle w ciągu 24 godzin. Do tego czasu górne menu pokazuje Vendor Pending…; napisz do @xproxyio z adresem e-mail konta, aby to przyspieszyćProxyMarket
  4. W międzyczasie zbuduj sprawdzanie stanu i uruchom serwer webhookówTy
  5. Utwórz klucz API w panelu sprzedawcyTy
  6. Wystaw plany, obsłuż zamówienia i sprawdzaj podpisy webhookówTy
  7. Złóż jedno prawdziwe zamówienie testowe i sprawdź, czy klient dostaje działające proxyTy + ProxyMarket

Dlaczego najpierw sprawdzanie stanu?

ProxyMarket sprawdza Twój serwer za pomocą HEAD {webhook_url}/health. To jedyny endpoint, który decyduje, czy Twoje plany pozostają w sprzedaży:

  • Przy tworzeniu klucza ProxyMarket wywołuje go raz. Błąd 5xx, odrzucone połączenie lub ponad 5 sekund: klucz nie powstaje (HTTP 422 z przyczyną).
  • Potem co 10 minut, dopóki klucz ma plany w sprzedaży, wywołuje go ponownie. Po 2 kolejnych niepowodzeniach wszystkie plany obsługiwane przez ten klucz są ukrywane w sklepie i nie można ich kupić. Jedna poprawna odpowiedź sama przywraca je wszystkie.
Liczy się jako działającyLiczy się jako niedziałający
Dowolny status poniżej 500, w ciągu 5 sekund. Bez logowania i bez treści odpowiedzi.Przekroczenie czasu, odrzucone połączenie lub dowolny status 5xx.
python
@app.route("/health", methods=["HEAD", "GET"])
def health():
    return "", 200   # no login, no database, no outside call

Umieść go pod swoim adresem webhooka: przy https://your-vendor-host.com/marketplace odpowiada pod /marketplace/health.

To najczęstszy powód, dla którego działający sklep po cichu przestaje sprzedawać. Wdrożenie, restart lub zapora blokująca HEAD mogą opróżnić cały Twój katalog w około 20 minut. Niech /health będzie Twoją najprostszą trasą: bez logowania, bez bazy danych, bez zewnętrznych wywołań; odpowiadaj też na GET.

Nie myl tego z raportowaniem stanu Twoich proxy (POST /api/integration/health). To wywołanie, które wykonujesz Ty w sprawie pojedynczych proxy; nie utrzymuje Twoich planów w sprzedaży.

Jak zdobyć klucz API?

Tworzysz go sam, gdy Twój wniosek sprzedawcy zostanie zatwierdzony; nikt Ci go nie wysyła. W panelu sprzedawcy nadaj kluczowi nazwę i podaj swój adres webhooka, na przykład https://your-vendor-host.com/marketplace. Możesz to też zrobić jednym wywołaniem (dokumentacja):

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
Klucz jest pokazywany tylko raz. ProxyMarket przechowuje tylko jego hash i nie może go odtworzyć. Zapisz go od razu. Jeśli go zgubisz, utwórz nowy.

Z tego jednego klucza otrzymujesz dwie wartości. Nie myl ich:

WartośćCzym jestDo czego służy
api_keySam klucz, zaczynający się od pm_Nagłówek X-API-Key w każdym Twoim wywołaniu
signing_keySHA256(api_key) jako 64-znakowy hexSprawdzanie X-Signature każdego webhooka (jak)

Klucz nigdy nie wygasa, a jego adresu webhooka nie można później zmienić: aby przenieść się na inny serwer, utwórz nowy klucz. Jeśli prowadzisz kilka niezależnych serwerów, daj każdemu własny klucz. Zamówienia trafiają do klucza ustawionego w polu API Key / Server każdego planu w panelu sprzedawcy. Plan utworzony przez synchronizację dostaje klucz, który go zsynchronizował; starszy plan bez tego ustawienia wysyła zamówienia do Twojego najstarszego aktywnego klucza.

Dodajesz drugi klucz? Plany utworzone wcześniej nadal trafiają do starszego klucza. Ustaw w nich API Key / Server na nowy klucz albo wyłącz stary. pm-connector test ostrzega, gdy plan trafia gdzie indziej.

Błędy: wywołanie bez nagłówka X-API-Key dostaje 422, błędny klucz 401, a klucz, którego wniosek sprzedawcy wciąż czeka, 403. Karta Integration Status w panelu sprzedawcy pokazuje dla każdego klucza, kiedy był ostatnio widziany, wersję konektora i ostatnie 20 dostarczeń z ich wynikiem.

Jak wystawić plany?

Wyślij wszystkie produkty przez publikację lub aktualizację planów przy starcie konektora i ponownie przy każdej zmianie. Zsynchronizowane plany są zatwierdzane od razu (plany dodane ręcznie w panelu czekają na administratora). Twój external_id to Twoje własne ID produktu (port, modem, pula VPN) i używa go każde późniejsze wywołanie i 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"}]}
Warto wiedziećDlaczego
Ponowne wysłanie tego samego external_id aktualizuje planSynchronizację można bezpiecznie powtarzać; nigdy nie tworzy duplikatów.
Plan, którego nie wyślesz, pozostaje w sprzedażyAby przestać go sprzedawać, wywołaj wycofanie planu ze sprzedaży.
Jako proxy_type używaj tylko mobile, residential, datacenter, isp, ipv6 lub vpnAPI przyjmie dowolny tekst, ale inna wartość psuje zamówienie: klient nigdy nie dostaje danych logowania. Zobacz VPN i VLESS.
country to pełna angielska nazwa, na przykład United StatesKlienci filtrują po dokładnym tekście, więc pisz ją tak samo w każdym planie (więcej). ProxyMarket jej nie sprawdza.
Plan jest widoczny tylko wtedy, gdy jest aktywny, dostępny, wystawiony i nieukryty przez sprawdzanie stanustock to zwykle 1 na port modemu: jeden klient na port.
Brak protocol oznacza HTTPMimo to wysyłaj go dla planów VPN i SOCKS5.
Plan utworzony przez synchronizację jest przypięty do klucza, który go zsynchronizowałJego zamówienia trafiają do tego klucza. Synchronizacja nigdy nie zmienia klucza istniejącego planu (więcej).

Co się dzieje, gdy ktoś kupuje?

  1. Klient płaci. Twoje 70% od razu trafia na Twoje saldo, jeszcze zanim Twój serwer zostanie wywołany.
  2. ProxyMarket wywołuje POST {webhook_url}/provision z order_id i Twoim external_plan_id (treść). Sprawdź podpis, a potem utwórz dostęp dla klienta.
  3. Odpowiadasz danymi logowania lub konfiguracją (najlepiej), statusem pending lub error. Zobacz tabelę poniżej.
  4. Klient widzi dane logowania w ProxyMarket i łączy się z Twoim serwerem. ProxyMarket sam zmniejsza dostępność planu o jeden.
  5. Gdy czas się skończy, ProxyMarket sam kończy zamówienie (sprawdza co 5 minut) i wywołuje POST {webhook_url}/deprovision. Usuwasz dostęp i przywracasz jednostkę do sprzedaży. Zobacz Gdy zamówienie się kończy.
status w odpowiedziKiedy go użyćCo się dzieje
provisioned (najlepiej)Możesz od razu utworzyć dostępKlient dostaje go natychmiast. Dodaj wszystkie cztery pola: proxy_ip, proxy_port, proxy_username, proxy_password, albo vpn_config_file dla VPN.
pendingPrzygotowanie zajmuje trochę czasuWyślij dane przez dostarczenie danych logowania lub konfiguracji VPN. ProxyMarket czeka łącznie 120 sekund, licząc od początku; potem zamówienie jest zwracane, a spóźnione dostarczenie dostaje 409.
errorNie możesz dostarczyć (port offline, brak wolnego profilu)Nic nie zostaje dostarczone. Po 120 sekundach klient dostaje zwrot do portfela, a Twój zarobek zostaje odjęty.
Zawsze odpowiadaj HTTP 200, nawet przy błędzie. Jeśli /provision odpowie innym statusem, przekroczy czas (po 30 sekundach), zwróci nieprawidłowy JSON lub poda provisioned z niepełnymi danymi logowania, ProxyMarket przekaże klientowi zamiast nich dane logowania zsynchronizowane w planie, jeśli takie są. Dostarczone dane logowania nigdy nie są kopiowane do planu, a dane logowania planu, które należą już do innego zamówienia, nie są używane ponownie: wtedy zamówienie jest zwracane. Wywołanie nie jest ponawiane.

expires_at w Twojej odpowiedzi jest ignorowane: ProxyMarket liczy czas od aktywacji i podaje go w /deprovision.

Czy mogę zaszyfrować odpowiedź na zwykłym adresie http://?

Tak, opcjonalnie. Odpowiedz 200 z nagłówkami X-PM-Encrypted: v1 i X-PM-Signature: sha256= + szesnastkowy HMAC-SHA256 surowej treści z Twoim kluczem podpisu jako kluczem oraz treścią {"enc": "v1", "nonce": "…", "ct": "…"}: losowym 12-bajtowym nonce i szyfrogramem AES-256-GCM Twojej zwykłej odpowiedzi (z dołączonym tagiem), oba w standardowym base64. Klucz to HKDF-SHA256 z bajtów UTF-8 Twojego klucza podpisu (pusta sól, info pm-provision-v1, 32 bajty), a AAD to order_id. ProxyMarket sprawdza podpis, odszyfrowuje i odczytuje odpowiedź jak zwykle; błędna koperta liczy się jak przekroczenie czasu. Pełny format i wektor testowy znajdziesz w dokumentacji API i w sekcji 5.1 przewodnika. pm-connector robi to sam na adresie http://. HTTPS nadal jest zalecany, bo żądania webhooków nie są szyfrowane.

Zapisz order_id: potrzebujesz go do spóźnionego dostarczenia, do samodzielnego zakończenia zamówienia i do dopasowania pozostałych webhooków.

Jak sprawdzić, czy webhook naprawdę pochodzi od ProxyMarket?

Każdy webhook POST zawiera X-Signature: sha256=…, czyli HMAC-SHA256 surowej treści. Sekretem jest Twój klucz podpisu, SHA256(api_key) jako hex, a nie sam klucz API. Sprawdzaj go w /provision, /deprovision i /update-settings, zanim zrobisz cokolwiek innego.

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

Używaj surowej treści żądania. Parsowanie JSON i ponowne zapisanie go zmienia bajty, a wtedy podpis przestaje się zgadzać.

Jak przetestować, zanim kupią klienci?

  1. Spoza swojej sieci uruchom curl -I https://your-vendor-host.com/marketplace/health i sprawdź, czy dostajesz status poniżej 500 w ciągu 5 sekund.
  2. Zsynchronizuj jeden plan i znajdź go na liście Browse na market.xproxy.io.
  3. Złóż na niego jedno prawdziwe zamówienie. Twój serwer powinien dostać /provision z poprawnym podpisem, a dane logowania powinny pojawić się w zamówieniu klienta.
  4. Połącz się tymi danymi, potem poczekaj na koniec zamówienia (lub poproś na Telegramie o jego zakończenie) i sprawdź, czy /deprovision usuwa dostęp, a dostępność wraca.

Daj znać ProxyMarket na Telegramie @xproxyio, gdy składasz zamówienie testowe, aby mogli je sprawdzić także po swojej stronie.

Jak aktualizować dostępność i stan?

Gdy po Twojej stronie dzieje się toWywołanie
Modem lub serwer przechodzi w tryb offlinePATCH /plans/stock z stock: 0, is_active: false
Wraca online albo sprzedany port znów jest wolnyPATCH /plans/stock z stock: 1, is_active: true
Zmienia się cena, nazwa lub konfiguracjaPOST /plans/sync tylko z tym planem
Przestajesz sprzedawać produktDELETE /plans/{external_id}
Opcjonalnie, co kilka minutPOST /health ze stanem i aktualnym IP każdego proxy. Zawsze dołączaj current_ip: jego brak czyści zapisany IP. Nie utrzymuje to Twoich planów w sprzedaży; robi to sprawdzanie stanu Twojego serwera.

Wszystkie ścieżki zaczynają się od https://market.xproxy.io/api/integration.

Co się dzieje, gdy zamówienie się kończy?

ProxyMarket wywołuje POST {webhook_url}/deprovision z polem reason:

PowódZnaczenie
expiredCzas wynajmu minął. Wysyłane automatycznie, z opóźnieniem do 5 minut.
renewedKlient zapłacił za przedłużenie działającego zamówienia. Stare zamówienie kończy się teraz, a potem przychodzi nowe /provision z nowym order_id.
cancelledAdministrator anulował zamówienie.
admin_refundAdministrator zwrócił klientowi pieniądze. Twój zarobek z tego zamówienia zostaje cofnięty.

Usuń dane logowania klienta (lub wyłącz jego profil VPN). Potem wyślij rzeczywistą liczbę wolnych jednostek przez PATCH /plans/stock: ProxyMarket sam przywraca dostępność po zwrocie, ale nie po wygaśnięciu. Odpowiedz {"status": "deprovisioned"}; odpowiedź jest tylko zapisywana w logu.

To wywołanie jest wysyłane raz i nigdy nie jest ponawiane. Jeśli Twój serwer w tym momencie nie działa, klient zachowuje dostęp. Dlatego kończ też każde zamówienie według własnego zegara, gdy minie jego czas (długość znasz z /provision). Zamówienie, którego nie udało się przygotować i które zostało automatycznie zwrócone, w ogóle nie dostaje /deprovision.

Oznaczenie zamówienia jako wygasłego zmienia tylko jego status w ProxyMarket, w każdym stanie, nawet anulowanym. Nie zwraca pieniędzy klientowi, nie zmienia dostępności i nie wywołuje Twojego webhooka.

Co, jeśli klient zmieni białą listę IP lub odcisk TCP?

Gdy klient zapisze Proxy Settings w aktywnym zamówieniu, ProxyMarket wywołuje POST {webhook_url}/update-settings. Jest wysyłane raz, dla każdego typu zamówienia. Zastosuj to, co obsługuje Twój system, i odpowiedz {"status": "ok"}; pole, którego nie obsługujesz, możesz zignorować. Treść nie zawiera external_plan_id, więc znajdź plan na podstawie order_id zapisanego przy provision.

  • ip_whitelist: tylko te adresy IP mogą korzystać z proxy. Zawsze lista pojedynczych adresów; [] oznacza brak ograniczenia IP.
  • tcp_fingerprint: jaki system ma przypominać połączenie (win1 Windows 11, mac1 macOS, ios1 iPhone 15, android1 Galaxy S24 i inne). null to wyłącza.

Jak sprzedawać VPN i VLESS?

Przebieg zamówienia jest taki sam; zmienia się tylko to, co dostarczasz. Wyślij kompletny plik klienta, dokładnie taki, jaki klient ma zaimportować.

ProduktPola planuDostarczasz
OpenVPNproxy_type: "vpn", protocol: "OpenVPN", vpn_protocol: "openvpn"Pełny tekst .ovpn z certyfikatami i kluczami w środku
WireGuardproxy_type: "vpn", protocol: "WireGuard", vpn_protocol: "wireguard"Pełny plik .conf z [Interface] i [Peer]
VLESS (Xray)proxy_type: "vpn", protocol: "VLESS", vpn_protocol: "vless"Jednolinijkowy link vless:// lub pełny JSON klienta Xray
Nigdy nie wysyłaj proxy_type: "xray". Sklep pokazuje plany VLESS jako „Xray”, ale ta etykieta pochodzi z vpn_protocol. API przyjmuje xray, a potem plan przestaje działać: klient płaci, a konfiguracja nigdy nie przychodzi.

Plik można dostarczyć na trzy sposoby:

  • Ten sam plik dla wszystkich w planie: umieść go w vpn_config_template przy synchronizacji.
  • Nowy plik dla każdego zamówienia: utwórz go w /provision i odpowiedz z vpn_config_file.
  • Nowy plik, którego przygotowanie trwa: odpowiedz pending, a potem wyślij vpn_config_file przez dostarczenie danych logowania lub konfiguracji VPN.

W VLESS daj każdemu zamówieniu własny UUID (wspólny UUID oznacza, że odebranie dostępu jednemu klientowi odbiera go wszystkim), podaj transport w opisie planu (na przykład XTLS-Reality lub WS+TLS) i usuń UUID z inbound po zakończeniu zamówienia.

Plik OpenVPN musi zawierać remote, dev tun lub dev tap albo jednocześnie client i blok <ca>; sam blok <ca> jest odrzucany. Każda konfiguracja musi mieć co najmniej 50 znaków.

Jak działa rotacja IP?

Dostarczony przez Ciebie rotation_link to adres URL, który wywołuje sam ProxyMarket zwykłym GET (z podążaniem za przekierowaniami, bez sprawdzania certyfikatu, limit czasu 15 sekund). Robi to, gdy klient kliknie Rotate, oraz według wybranego przez klienta zegara automatycznej rotacji (co 5 do 60 minut), a przestaje po zakończeniu zamówienia. Klient też widzi ten link i może go otworzyć.

Jeśli jako rozwiązanie zastępcze przekazywany jest rotation_link samego planu (zobacz wyżej), nigdy nie jest to link należący już do innego zamówienia.

Czy istnieje gotowy serwer webhooków?

Tak: konektor ProxyMarket (pm-connector) działa na Twoim serwerze Linux lub Windows i robi za Ciebie wszystko, co opisuje ta strona. Dajesz mu tylko jeden mały skrypt, który dodaje i usuwa dane logowania klienta w Twoim systemie; gotowe skrypty w Pythonie, Node.js i shellu są na jego stronie.

  • Odpowiada na webhooki, sprawdzając podpisy, tworzy nazwę użytkownika i hasło klienta w Twoim systemie i usuwa je po zakończeniu wynajmu.
  • Łączy się z ProxyMarket przez ProxyMarket hook (typ klucza ProxyMarket hook): jedno połączenie wychodzące do market-hook-service.xproxy.io, więc serwer nie potrzebuje otwartego portu ani domeny. Klienci zawsze łączą się bezpośrednio z portem Twojego proxy.
  • Nadrabia zaległości po przestoju: zamówienia, które skończyły się, gdy był offline, tracą użytkownika, gdy tylko wróci.

Plany tworzysz w Vendor Dashboard. Jeśli chcesz, aby ProxyMarket wywoływał Twój własny adres HTTPS zamiast hooka, zobacz korzystanie z własnego adresu.

Jak otrzymuję pieniądze?

Twój udział70% każdej sprzedaży (stawka standardowa; może być ustalana indywidualnie dla sprzedawcy)
Udział ProxyMarket30%, za sklep, płatności, wsparcie i zwroty
Kiedy jest naliczanyGdy tylko płatność klienta zostanie zaksięgowana, a zamówienie stanie się aktywne, zanim Twoje /provision zostanie wywołane
Gdzie go widziszEarnings w panelu sprzedawcy: każda sprzedaż z kwotą, Twoją kwotą i zastosowaną stawką
WypłatyWypłaca je administrator ProxyMarket z Twojego salda. Gdy chcesz wypłacić środki, napisz na Telegramie.
ZwrotyAutomatyczny zwrot (nic nie dostarczono w ciągu 120 sekund) lub zwrot przez administratora odejmuje zarobek od Twojego salda. Kod promocyjny obniża kwotę sprzedaży, a wraz z nią Twój udział.
WypłacanieWypłata może wynieść maksymalnie tyle, ile Twoje saldo, i oznacza Twoje najstarsze niewypłacone zarobki jako wypłacone.

Stawka jest zapisywana przy każdej sprzedaży, więc późniejsza zmiana stawki nigdy nie wpływa na już zarobione pieniądze.

Gdzie moje plany pojawiają się w sklepie?

Browse pokazuje plany od najtańszych, z jedną zasadą, którą warto znać przed ustaleniem cen: plany sprzedawców korzystających z oprogramowania XProxy są na górze, pod etykietą Powered by xProxy, z plakietką xProxy. Plany z Twojego własnego konektora są niżej, pod Other vendors, również od najtańszych.

GdzieCo decyduje o kolejności
Browse, domyślnieNajpierw grupa XProxy, potem Twoja, każda od najtańszych
Browse, gdy klient sortujeSortowanie działa w obrębie każdej grupy, więc Twój tańszy plan nadal jest pod grupą XProxy
Karty „from $X” na stronie głównejNajtańszy plan XProxy w każdej kategorii; Twój tylko wtedy, gdy XProxy nie ma tam dostępnych planów
Filtry kraju, protokołu i wyszukiwania, Twoja strona sklepuDokładnie tak samo dla każdego sprzedawcy

Gdy wszystkie wystawione plany należą do jednej grupy, Browse pokazuje jedną płaską listę bez nagłówków. Większość klientów trafia do planów, filtrując po kraju lub protokole, a tam Twoje plany stoją obok wszystkich innych.

Co oznaczają kody błędów?

KodZnaczenieCo zrobić
401Invalid API key (błędny lub wyłączony klucz), Missing API key (pusty nagłówek) lub Vendor inactiveSprawdź nagłówek X-API-Key i czy klucz jest włączony w panelu
403Twój wniosek sprzedawcy wciąż czeka (przy każdym wywołaniu) lub konto nie jest zatwierdzonym sprzedawcą (tworzenie klucza)Poczekaj na zatwierdzenie
404Nieznany external_id lub order_idSprawdź ID; najpierw zsynchronizuj plan
409Dostarczanie danych logowania do zamówienia, które nie jest już opłacone ani aktywneZwykle minęło 120 sekund i zamówienie zostało zwrócone. Nie ponawiaj
422Wartość jest nieprawidłowa albo całkowicie brakuje nagłówka X-API-Keydetail w odpowiedzi wskazuje pole
500Błąd ProxyMarketPonawiaj z rosnącym odstępem

Błędy wracają jako {"detail": "…"}. Nie ma opublikowanych limitów zapytań; synchronizuj przy zmianach, a nie w ciasnej pętli.

Czy jest pełny przykład?

Tak. Ten konektor w Pythonie synchronizuje jeden plan proxy, co 5 minut raportuje stan i odpowiada na wszystkie cztery webhooki. Zastąp dwie funkcje na górze wywołaniami własnego systemu i dodaj zegar, który kończy każde zamówienie, gdy minie jego czas.

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)

Gdzie jest pełna dokumentacja API?

Każde wywołanie i webhook, ze wszystkimi polami, przykładowymi odpowiedziami i kodem w curl, Pythonie, Node.js i PHP, znajdziesz w dokumentacji API ProxyMarket. Plik OpenAPI 3.1 jest pod adresem market.openapi.yaml.

KierunekEndpointCo robi
Ty wywołujeszPOST /api/vendor/integrationsTworzy Twój klucz API
Ty wywołujeszPOST /plans/syncPublikuje lub aktualizuje plany
Ty wywołujeszPATCH /plans/stockZmienia dostępność i widoczność
Ty wywołujeszDELETE /plans/{external_id}Wycofuje plan ze sprzedaży
Ty wywołujeszPOST /healthRaportuje stan Twoich proxy
Ty wywołujeszPOST /orders/{order_id}/credentialsDostarcza dane logowania lub konfigurację z opóźnieniem
Ty wywołujeszPOST /orders/{order_id}/expireOznacza zamówienie jako wygasłe (bez zwrotu)
My wywołujemyHEAD /healthSprawdzanie stanu, które utrzymuje Twoje plany w sprzedaży
My wywołujemyPOST /provisionKlient zapłacił: dostarcz
My wywołujemyPOST /deprovisionZamówienie się skończyło: usuń dostęp
My wywołujemyPOST /update-settingsZastosuj nową białą listę IP lub odcisk TCP
Ty wywołujeszGET /orders/activeOpłacone i aktywne zamówienia skierowane do Twojego klucza

Jakie kraje mogę wystawiać?

Dowolne. Wysyłaj pełną angielską nazwę kraju, na przykład United States, Germany lub Vietnam, i pisz ją tak samo w każdym planie: klienci filtrują po dokładnym tekście. ProxyMarket nie sprawdza nazwy; lista w przewodniku i w panelu sprzedawcy określa pisownię, której należy używać. pm-connector test odrzuca nazwę spoza tej listy.

Co się zmieniło w wersji 1.13?

  • Nowe wywołanie: lista zamówień skierowanych do Twojego klucza (GET /orders/active, z routed_plans i ETag), do nadrabiania zaległości po przestoju.
  • Bezpieczniejsze rozwiązanie zastępcze: dostarczone dane logowania nie są już kopiowane do planu, a dane logowania planu lub link do rotacji należące do innego zamówienia nigdy nie są przekazywane.
  • Moment provision: /provision jest wysyłane dopiero po zatwierdzeniu płatności, więc natychmiastowe wysłanie danych logowania jest akceptowane. /update-settings zawsze zawiera wartości, które klient właśnie zapisał.
  • Konektor ProxyMarket: gotowy serwer webhooków, łącznie z dostępem do niego za NAT. Zobacz konektor.
  • Szyfrowana odpowiedź provision (opcjonalnie): na zwykłym adresie webhooka http:// zabezpiecz odpowiedź /provision nagłówkiem X-PM-Encrypted: v1. Zobacz wyżej.
  • Przypinanie planów: plan utworzony przez synchronizację trafia do klucza, który go zsynchronizował.
  • Rotacja: ProxyMarket wywołuje Twój rotation_link przez GET. Zobacz rotacja IP.
  • Karta Integration Status w panelu sprzedawcy i opcjonalny nagłówek X-PM-Connector.
  • Opisane zgodnie z kodem: 422 bez nagłówka X-API-Key, 403, gdy Twój wniosek czeka, 30-sekundowy limit czasu provision, niesprawdzane kraj i port przy synchronizacji, protocol domyślnie HTTP, raport /health bez current_ip czyści go, zasada <ca> dla OpenVPN i brak external_plan_id w /update-settings.

FAQ

Używam XProxy. Czy muszę to budować?

Nie. Włącz ProxyMarket w panelu (Selling Platform → ProxyMarket), a zrobi to wszystko za Ciebie, łącznie z webhookami. Zobacz Sprzedaż na ProxyMarket. Twoje plany dostaną wtedy także plakietkę xProxy.

Dlaczego wszystkie moje plany zniknęły ze sklepu?

Prawie zawsze z powodu sprawdzania stanu: HEAD {webhook_url}/health nie powiodło się dwa razy z rzędu (serwer nie działał, odpowiedź trwała dłużej niż 5 sekund, błąd 5xx lub zablokowany HEAD). Napraw to, a plany wrócą po następnej udanej kontroli, w ciągu 10 minut.

Zgubiłem klucz API. Czy ProxyMarket może go wysłać ponownie?

Nie. Przechowywany jest tylko hash. Utwórz nowy klucz i pamiętaj, że razem z nim zmienia się klucz podpisu.

Sprawdzanie podpisu zawsze się nie udaje. Dlaczego?

Zwykle z jednego z dwóch powodów: użyłeś surowego klucza API jako sekretu HMAC zamiast SHA256(api_key) w hex albo podpisałeś sparsowany i ponownie zakodowany JSON zamiast surowej treści żądania.

Czy dostanę pieniądze, jeśli mój serwer nie dostarczy proxy?

Nie. Jeśli w ciągu 120 sekund nie przyjdzie nic użytecznego, klient dostaje zwrot, a zarobek zostaje odjęty od Twojego salda.

Dlaczego klient dostał stare dane logowania?

Twoje /provision odpowiedziało statusem innym niż 200, przekroczyło czas lub wysłało nieprawidłowy JSON, więc ProxyMarket przekazał dane logowania zsynchronizowane w planie. Dostarczone dane logowania nigdy nie są zapisywane w planie, a dane logowania planu nie są używane ponownie, gdy należą już do innego zamówienia (wtedy zamówienie jest zwracane). Zawsze odpowiadaj 200, z error, jeśli nie możesz dostarczyć.

Czy mogę podłączyć kilka serwerów?

Tak. Utwórz jeden klucz na serwer, każdy z własnym adresem webhooka. Plan utworzony przez synchronizację trafia do klucza, który go zsynchronizował; w starszych planach ustaw API Key / Server w panelu, inaczej ich zamówienia trafią do Twojego najstarszego klucza.

Co się dzieje, gdy klient przedłuża plan?

Przedłużenie wygasłego zamówienia to zwykłe nowe zamówienie. Przedłużenie działającego najpierw wysyła /deprovision z reason: renewed dla starego zamówienia, a potem /provision dla nowego, z nowym order_id.

Co dalej?

Otwórz pełną dokumentację albo zapytaj ProxyMarket na Telegramie.

Nadal masz problem?Technik może sprawdzić Twoje urządzenie za pomocą jednorazowego PIN-u. Możesz też napisać do nas na Telegramie.