API

Guide de l'API

Tout ce que fait le dashboard — appairage, identifiants, rotation, consommation — tient dans une seule API REST. URL de base https://mobileproxy.app/api/v1. Authentifiez-vous avec un jeton bearer.

Authentification

Créez un jeton dans le dashboard sous Pour les développeurs → Jetons API, ou avec POST /tokens une fois connecté. Le secret n'est affiché qu'une seule fois — conservez-le. Envoyez-le à chaque requête :

Authorization: Bearer mpx_live_…

Essayez en direct

La console interactive vous permet de coller un jeton et d'appeler chaque endpoint depuis le navigateur, avec corps de requête et réponses réelles. La spécification complète est à /api/v1/openapi.json.

Erreurs

Les erreurs sont en JSON, avec un message lisible et un code machine :

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

Champ	Type	Description
401	unauthorized	Jeton manquant, mal formé ou révoqué.
403	forbidden	Jeton valide mais non autorisé.
404	not_found	La ressource n'existe pas sur ce compte.
502	control_plane_unavailable	Passerelle brièvement injoignable — réessayez.

Recettes courantes

Lister vos appareils avec leur statut en direct et leur IP de sortie :

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

Faire tourner l'IP d'un appareil et le confirmer depuis l'historique des 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_…"

Provisionner un proxy pour un nouveau client — un identifiant, prêt à être remis :

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

Lire la consommation à l'échelle du compte pour la facturation :

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

Référence complète

Chaque endpoint, paramètre, schéma et exemple de réponse se trouve dans la console interactive. Elle s'affiche en direct à partir du même document OpenAPI sur lequel l'API est construite, elle n'est donc jamais périmée.