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ądarceAsystenci czatu
Otwórz w ChatGPTNowa kartaOtwórz w ClaudeNowa kartaKopiuj
Pokaż jako MarkdownCzysty tekst dla narzędzi AIZobacz 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.
W skrócie
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.
Sprawdzanie stanu co 10 minut, a do tego webhook, gdy klient zapłaci, gdy zamówienie się skończy i gdy klient zmieni ustawienie.
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?
Jakie są kroki do uruchomienia sprzedaży?
Wykonaj je w tej kolejności. Kroki 1–3 to konfiguracja konta; kroki 4–7 to integracja.
- Załóż zwykłe konto na market.xproxy.ioTy
- Złóż wniosek o status sprzedawcy (Become Vendor w górnym menu)Ty
- 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
- W międzyczasie zbuduj sprawdzanie stanu i uruchom serwer webhookówTy
- Utwórz klucz API w panelu sprzedawcyTy
- Wystaw plany, obsłuż zamówienia i sprawdzaj podpisy webhookówTy
- 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ący | Liczy 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. |
@app.route("/health", methods=["HEAD", "GET"])
def health():
return "", 200 # no login, no database, no outside callUmieść go pod swoim adresem webhooka: przy https://your-vendor-host.com/marketplace odpowiada pod /marketplace/health.
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):
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 nowZ tego jednego klucza otrzymujesz dwie wartości. Nie myl ich:
| Wartość | Czym jest | Do czego służy |
|---|---|---|
api_key | Sam klucz, zaczynający się od pm_ | Nagłówek X-API-Key w każdym Twoim wywołaniu |
signing_key | SHA256(api_key) jako 64-znakowy hex | Sprawdzanie 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.
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.
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 plan | Synchronizację można bezpiecznie powtarzać; nigdy nie tworzy duplikatów. |
| Plan, którego nie wyślesz, pozostaje w sprzedaży | Aby przestać go sprzedawać, wywołaj wycofanie planu ze sprzedaży. |
Jako proxy_type używaj tylko mobile, residential, datacenter, isp, ipv6 lub vpn | API 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 States | Klienci 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 stanu | stock to zwykle 1 na port modemu: jeden klient na port. |
Brak protocol oznacza HTTP | Mimo 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?
- Klient płaci. Twoje 70% od razu trafia na Twoje saldo, jeszcze zanim Twój serwer zostanie wywołany.
- ProxyMarket wywołuje
POST {webhook_url}/provisionzorder_idi Twoimexternal_plan_id(treść). Sprawdź podpis, a potem utwórz dostęp dla klienta. - Odpowiadasz danymi logowania lub konfiguracją (najlepiej), statusem
pendingluberror. Zobacz tabelę poniżej. - Klient widzi dane logowania w ProxyMarket i łączy się z Twoim serwerem. ProxyMarket sam zmniejsza dostępność planu o jeden.
- 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 odpowiedzi | Kiedy go użyć | Co się dzieje |
|---|---|---|
provisioned (najlepiej) | Możesz od razu utworzyć dostęp | Klient dostaje go natychmiast. Dodaj wszystkie cztery pola: proxy_ip, proxy_port, proxy_username, proxy_password, albo vpn_config_file dla VPN. |
pending | Przygotowanie zajmuje trochę czasu | Wyś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. |
error | Nie 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. |
/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.
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?
- Spoza swojej sieci uruchom
curl -I https://your-vendor-host.com/marketplace/healthi sprawdź, czy dostajesz status poniżej 500 w ciągu 5 sekund. - Zsynchronizuj jeden plan i znajdź go na liście Browse na market.xproxy.io.
- Złóż na niego jedno prawdziwe zamówienie. Twój serwer powinien dostać
/provisionz poprawnym podpisem, a dane logowania powinny pojawić się w zamówieniu klienta. - Połącz się tymi danymi, potem poczekaj na koniec zamówienia (lub poproś na Telegramie o jego zakończenie) i sprawdź, czy
/deprovisionusuwa 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ę to | Wywołanie |
|---|---|
| Modem lub serwer przechodzi w tryb offline | PATCH /plans/stock z stock: 0, is_active: false |
| Wraca online albo sprzedany port znów jest wolny | PATCH /plans/stock z stock: 1, is_active: true |
| Zmienia się cena, nazwa lub konfiguracja | POST /plans/sync tylko z tym planem |
| Przestajesz sprzedawać produkt | DELETE /plans/{external_id} |
| Opcjonalnie, co kilka minut | POST /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ód | Znaczenie |
|---|---|
expired | Czas wynajmu minął. Wysyłane automatycznie, z opóźnieniem do 5 minut. |
renewed | Klient 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. |
cancelled | Administrator anulował zamówienie. |
admin_refund | Administrator 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.
/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 (win1Windows 11,mac1macOS,ios1iPhone 15,android1Galaxy S24 i inne).nullto 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ć.
| Produkt | Pola planu | Dostarczasz |
|---|---|---|
| OpenVPN | proxy_type: "vpn", protocol: "OpenVPN", vpn_protocol: "openvpn" | Pełny tekst .ovpn z certyfikatami i kluczami w środku |
| WireGuard | proxy_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 |
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_templateprzy synchronizacji. - Nowy plik dla każdego zamówienia: utwórz go w
/provisioni odpowiedz zvpn_config_file. - Nowy plik, którego przygotowanie trwa: odpowiedz
pending, a potem wyślijvpn_config_fileprzez 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ł ProxyMarket | 30%, za sklep, płatności, wsparcie i zwroty |
| Kiedy jest naliczany | Gdy tylko płatność klienta zostanie zaksięgowana, a zamówienie stanie się aktywne, zanim Twoje /provision zostanie wywołane |
| Gdzie go widzisz | Earnings w panelu sprzedawcy: każda sprzedaż z kwotą, Twoją kwotą i zastosowaną stawką |
| Wypłaty | Wypłaca je administrator ProxyMarket z Twojego salda. Gdy chcesz wypłacić środki, napisz na Telegramie. |
| Zwroty | Automatyczny 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łacanie | Wypł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.
| Gdzie | Co decyduje o kolejności |
|---|---|
| Browse, domyślnie | Najpierw grupa XProxy, potem Twoja, każda od najtańszych |
| Browse, gdy klient sortuje | Sortowanie 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łównej | Najtań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 sklepu | Dokł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?
| Kod | Znaczenie | Co zrobić |
|---|---|---|
401 | Invalid API key (błędny lub wyłączony klucz), Missing API key (pusty nagłówek) lub Vendor inactive | Sprawdź nagłówek X-API-Key i czy klucz jest włączony w panelu |
403 | Twój wniosek sprzedawcy wciąż czeka (przy każdym wywołaniu) lub konto nie jest zatwierdzonym sprzedawcą (tworzenie klucza) | Poczekaj na zatwierdzenie |
404 | Nieznany external_id lub order_id | Sprawdź ID; najpierw zsynchronizuj plan |
409 | Dostarczanie danych logowania do zamówienia, które nie jest już opłacone ani aktywne | Zwykle minęło 120 sekund i zamówienie zostało zwrócone. Nie ponawiaj |
422 | Wartość jest nieprawidłowa albo całkowicie brakuje nagłówka X-API-Key | detail w odpowiedzi wskazuje pole |
500 | Błąd ProxyMarket | Ponawiaj 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.
"""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.
| Kierunek | Endpoint | Co robi |
|---|---|---|
| Ty wywołujesz | POST /api/vendor/integrations | Tworzy Twój klucz API |
| Ty wywołujesz | POST /plans/sync | Publikuje lub aktualizuje plany |
| Ty wywołujesz | PATCH /plans/stock | Zmienia dostępność i widoczność |
| Ty wywołujesz | DELETE /plans/{external_id} | Wycofuje plan ze sprzedaży |
| Ty wywołujesz | POST /health | Raportuje stan Twoich proxy |
| Ty wywołujesz | POST /orders/{order_id}/credentials | Dostarcza dane logowania lub konfigurację z opóźnieniem |
| Ty wywołujesz | POST /orders/{order_id}/expire | Oznacza zamówienie jako wygasłe (bez zwrotu) |
| My wywołujemy | HEAD /health | Sprawdzanie stanu, które utrzymuje Twoje plany w sprzedaży |
| My wywołujemy | POST /provision | Klient zapłacił: dostarcz |
| My wywołujemy | POST /deprovision | Zamówienie się skończyło: usuń dostęp |
| My wywołujemy | POST /update-settings | Zastosuj nową białą listę IP lub odcisk TCP |
| Ty wywołujesz | GET /orders/active | Opł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, zrouted_plansi 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:
/provisionjest wysyłane dopiero po zatwierdzeniu płatności, więc natychmiastowe wysłanie danych logowania jest akceptowane./update-settingszawsze 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ź/provisionnagłówkiemX-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_linkprzezGET. 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,protocoldomyślnie HTTP, raport/healthbezcurrent_ipczyści go, zasada<ca>dla OpenVPN i brakexternal_plan_idw/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.

