API

Οδηγός API

Ό,τι κάνει το dashboard — σύζευξη, διαπιστευτήρια, εναλλαγή, χρήση — είναι ένα REST API. Βασικό URL https://mobileproxy.app/api/v1. Πιστοποιηθείτε με bearer token.

Πιστοποίηση

Δημιουργήστε ένα token στο dashboard, στην ενότητα Για προγραμματιστές → API tokens, ή με POST /tokens ενώ είστε συνδεδεμένοι. Το μυστικό εμφανίζεται μία φορά — αποθηκεύστε το. Στείλτε το σε κάθε αίτημα:

Authorization: Bearer mpx_live_…

Δοκιμάστε το ζωντανά

Η διαδραστική κονσόλα σας επιτρέπει να επικολλήσετε ένα token και να καλέσετε κάθε endpoint από τον browser, με σώματα αιτημάτων και πραγματικές απαντήσεις. Η πλήρης προδιαγραφή βρίσκεται στο /api/v1/openapi.json.

Σφάλματα

Τα σφάλματα είναι JSON με ένα ανθρώπινο μήνυμα και έναν κωδικό για μηχανές:

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

Πεδίο	Τύπος	Περιγραφή
401	unauthorized	Το token λείπει, είναι κακοδιατυπωμένο ή ανακλήθηκε.
403	forbidden	Το token είναι έγκυρο αλλά δεν επιτρέπεται.
404	not_found	Ο πόρος δεν υπάρχει σε αυτόν τον λογαριασμό.
502	control_plane_unavailable	Το gateway ήταν στιγμιαία μη προσβάσιμο — δοκιμάστε ξανά.

Συνηθισμένες συνταγές

Δείτε τις συσκευές σας με ζωντανή κατάσταση και IP εξόδου:

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

Εναλλάξτε την IP μιας συσκευής και επιβεβαιώστε από το ιστορικό 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_…"

Παρέχετε ένα proxy για νέο πελάτη — ένα διαπιστευτήριο, έτοιμο για παράδοση:

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

Διαβάστε τη χρήση όλου του λογαριασμού για χρέωση:

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

Πλήρης αναφορά

Κάθε endpoint, παράμετρος, σχήμα και παράδειγμα απάντησης βρίσκεται στη διαδραστική κονσόλα. Αποδίδεται ζωντανά από το ίδιο έγγραφο OpenAPI στο οποίο είναι χτισμένο το API, οπότε δεν αποκλίνει ποτέ.