Utiliser votre proxy

SMS / codes de vérification

Un téléphone que vous avez appairé peut transférer les SMS reçus par sa SIM — les codes de vérification à usage unique (OTP), le plus utile — vers votre compte. Lisez-les dans le dashboard ou via l'API, par appareil.

À quoi ça sert

Se connecter à un compte depuis une IP mobile déclenche souvent l'envoi d'un code de vérification par SMS au numéro de ce téléphone. Si le téléphone est un que vous possédez et avez appairé, l'application peut capturer ces messages entrants et vous les remonter — pour que vous puissiez lire le code sans tenir physiquement l'appareil. C'est l'usage prévu : des OTP sur des téléphones que vous possédez.

Optionnel, et désactivé sauf si vous l'autorisez

La capture des SMS repose sur une autorisation optionnelle (RECEIVE_SMS). Le proxy fonctionne pleinement sans elle. Si vous refusez la demande sur le téléphone, rien n'est capturé et la liste reste vide — tout le reste continue de fonctionner.

Comment ça marche

Lorsqu'un SMS arrive sur le téléphone, l'application le lit (en concaténant les parties d'un message multipartie en un seul), le met en file d'attente sur l'appareil, et transfère le lot en file vers votre compte via le même lien lié au cellulaire que le téléphone utilise déjà pour communiquer avec le plan de contrôle. Le transfert se fait lors du cycle de sondage habituel du téléphone (~25 s), donc un code apparaît en quelques secondes après son arrivée. Si le téléphone est brièvement hors ligne, les messages sont mis en tampon sur l'appareil et envoyés à son retour. Chaque message stocké conserve l'expéditeur, le corps et l'heure de réception.

Sideload uniquement

Google Play restreint les autorisations SMS, donc cette fonctionnalité n'existe que dans l'APK sideloadé. Voir Télécharger pour comprendre pourquoi l'application est sideloadée et ce qu'elle capture.

Les lire dans le dashboard

Chaque carte d'appareil comporte un panneau repliable SMS reçus. Ouvrez-le et il liste les messages du plus récent au plus ancien — expéditeur, horodatage et corps complet — et se rafraîchit de lui-même toutes les ~15 secondes tant qu'il est ouvert, de sorte qu'un code qui arrive en pleine inscription apparaît sans recharger la page. Un badge de décompte indique combien de messages se trouvent sur l'appareil. Si le téléphone n'a jamais reçu l'autorisation SMS, le panneau indique simplement qu'il n'y a pas encore de message.

Les lire via l'API

Les mêmes messages sont disponibles par appareil. La liste va du plus récent au plus ancien et est plafonnée aux 200 plus récents.

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

# → {
#     "subscription_id": "sub_760c1fc8ddab",
#     "messages": [
#       { "id": "1042",
#         "sender": "+15550101",
#         "body": "Your verification code is 314159",
#         "received_at": "2026-07-05T14:12:00.000Z" }
#     ]
#   }

Chaque message porte un id, l<mono>sender</mono> (ladresse d'origine, qui peut être null pour certains expéditeurs à numéro court), le body du message, et received_at. L'endpoint renvoie un tableau messages vide — jamais une erreur — lorsque le téléphone n'a rien transféré, y compris lorsque l'autorisation SMS a été refusée.

Astuce

Authentifiez-vous avec un jeton API utilisateur (mpx_live_…) de la même façon que pour le reste de l'API, ou lisez-le depuis la session du dashboard. L'appareil doit appartenir à votre compte, sinon vous obtiendrez un 404.

Les détails champ par champ sont dans la console API interactive, aux côtés du reste de Statut et consommation.