API

Vodnik za API

Vse, kar počne nadzorna plošča — seznanjanje, poverilnice, rotacija, poraba — je en sam REST API. Osnovni naslov URL je https://mobileproxy.app/api/v1. Preverjanje pristnosti poteka z žetonom nosilca.

Preverjanje pristnosti

Ustvarite žeton v nadzorni plošči pod Za razvijalce → API žetoni ali z POST /tokens, ko ste prijavljeni. Skrivnost je prikazana enkrat — shranite jo. Pošljite jo ob vsakem zahtevku:

Authorization: Bearer mpx_live_…

Preizkusite v živo

Interaktivna konzola omogoča, da prilepite žeton in pokličete vsako končno točko iz brskalnika, z zahtevki in resničnimi odzivi. Celotna specifikacija je na /api/v1/openapi.json.

Napake

Napake so v obliki JSON s človeku razumljivim sporočilom in strojno kodo:

{ "error": "No such device.", "code": "not_found" }

Polje	Tip	Opis
401	unauthorized	Žeton manjka, je napačno oblikovan ali preklican.
403	forbidden	Žeton je veljaven, a nima dovoljenja.
404	not_found	Vir na tem računu ne obstaja.
502	control_plane_unavailable	Prehod je za trenutek nedosegljiv — poskusite znova.

Pogosti recepti

Naštejte svoje naprave z živim stanjem in izhodnim naslovom IP:

curl https://mobileproxy.app/api/v1/subscriptions \
     -H "Authorization: Bearer mpx_live_…"

Zavrtite napravin naslov IP in potrdite iz zgodovine IP:

curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/change-ip \
     -H "Authorization: Bearer mpx_live_…"

curl https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/ip-history \
     -H "Authorization: Bearer mpx_live_…"

Pripravite proxy za novo stranko — ena poverilnica, pripravljena za predajo:

curl -X POST https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/proxies \
     -H "Authorization: Bearer mpx_live_…"
# → returns endpoint: socks5h://user:pass@host:port

Preberite porabo za celoten račun za obračun:

curl https://mobileproxy.app/api/v1/usage/summary \
     -H "Authorization: Bearer mpx_live_…"

Celoten priročnik

Vsaka končna točka, parameter, shema in primer odziva so v interaktivni konzoli. Izrisuje se v živo iz istega dokumenta OpenAPI, na katerem temelji API, zato nikoli ne zastara.