API

API-Leitfaden

Alles, was das Dashboard kann – Pairing, Zugangsdaten, Rotation, Nutzung – ist eine REST-API. Basis-URL https://mobileproxy.app/api/v1. Authentifizierung per Bearer-Token.

Authentifizierung

Erstellen Sie ein Token im Dashboard unter Für Entwickler → API-Tokens oder mit POST /tokens, während Sie angemeldet sind. Das Secret wird nur einmal angezeigt – speichern Sie es. Senden Sie es bei jeder Anfrage mit:

Authorization: Bearer mpx_live_…

Live ausprobieren

In der interaktiven Konsole können Sie ein Token einfügen und jeden Endpunkt direkt im Browser aufrufen – mit Anfragekörpern und echten Antworten. Die vollständige Spezifikation finden Sie unter /api/v1/openapi.json.

Fehler

Fehler sind JSON mit einer verständlichen Meldung und einem maschinenlesbaren Code:

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

Feld	Typ	Beschreibung
401	unauthorized	Token fehlt, ist fehlerhaft oder widerrufen.
403	forbidden	Token gültig, aber nicht berechtigt.
404	not_found	Ressource existiert auf diesem Konto nicht.
502	control_plane_unavailable	Gateway kurzzeitig nicht erreichbar – erneut versuchen.

Häufige Rezepte

Geräte auflisten mit Live-Status und Exit-IP:

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

IP eines Geräts rotieren und über den IP-Verlauf bestätigen:

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_…"

Proxy für einen neuen Kunden bereitstellen – eine Zugangsdaten, sofort übergabebereit:

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

Kontoweite Nutzung auslesen für die Abrechnung:

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

Vollständige Referenz

Jeder Endpunkt, Parameter, jedes Schema und jede Beispielantwort finden Sie in der interaktiven Konsole. Sie wird live aus demselben OpenAPI-Dokument gerendert, aus dem die API aufgebaut ist, und ist daher nie veraltet.