Je proxy gebruiken

SMS / verificatiecodes

Een telefoon die je hebt gekoppeld kan de SMS die zijn SIM ontvangt — het nuttigst: eenmalige verificatiecodes (OTP's) — naar je account doorsturen. Lees ze in het dashboard of via de API, per apparaat.

Waar dit voor is

Inloggen op een account vanaf een mobiel IP zet vaak een SMS-verificatiecode in gang die naar het nummer van die telefoon wordt gestuurd. Als de telefoon er een is die je bezit en hebt gekoppeld, kan de app die inkomende berichten opvangen en aan je tonen — zodat je de code kunt lezen zonder het apparaat fysiek vast te houden. Dat is het bedoelde gebruik: OTP's op telefoons die je bezit.

Optioneel, en uit tenzij je het toestaat

SMS-opvang berust op een optionele permissie (RECEIVE_SMS). De proxy werkt volledig zonder. Als je de prompt op de telefoon weigert, wordt niets opgevangen en blijft de lijst leeg — al het andere blijft draaien.

Hoe het werkt

Wanneer een SMS op de telefoon binnenkomt, leest de app hem (waarbij de delen van een multipart-bericht tot één worden samengevoegd), zet hem in de wachtrij op het apparaat, en stuurt de batch in de wachtrij naar je account door over dezelfde mobiel-gebonden verbinding die de telefoon al gebruikt om met de control plane te praten. Doorsturen gebeurt tijdens de gewone poll-cyclus van de telefoon (~25 s), dus een code verschijnt binnen enkele seconden na aankomst. Is de telefoon even offline, dan bufferen berichten op het apparaat en worden ze verstuurd zodra hij terug is. Elk opgeslagen bericht bewaart de afzender, de inhoud en het ontvangsttijdstip.

Alleen via sideload

Google Play beperkt SMS-permissies, dus deze functie bestaat alleen in de gesideloade APK. Zie Downloaden voor waarom de app wordt gesideload en wat hij opvangt.

Ze in het dashboard lezen

Elke apparaatkaart heeft een inklapbaar paneel Ontvangen SMS. Open je het, dan toont het berichten nieuwste-eerst — afzender, tijdstip en volledige inhoud — en het vernieuwt vanzelf elke ~15 seconden zolang het open is, zodat een code die midden in een aanmelding binnenkomt verschijnt zonder de pagina te herladen. Een teller-badge toont hoeveel berichten er op het apparaat staan. Kreeg de telefoon nooit de SMS-permissie, dan meldt het paneel simpelweg dat er nog geen berichten zijn.

Ze via de API lezen

Dezelfde berichten zijn per apparaat beschikbaar. De lijst is nieuwste-eerst en beperkt tot de meest recente 200.

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" }
#     ]
#   }

Elk bericht bevat een id, de sender (het afzendadres, dat null kan zijn voor sommige short-code-afzenders), de body van het bericht, en received_at. Het endpoint geeft een lege messages-array terug — nooit een fout — wanneer de telefoon niets heeft doorgestuurd, ook wanneer de SMS-permissie werd geweigerd.

Tip

Authenticeer met een gebruikers-API-token (mpx_live_…) op dezelfde manier als de rest van de API, of lees het uit de dashboardsessie. Het apparaat moet bij je account horen, anders krijg je een 404.

Details veld voor veld staan in de interactieve API-console, naast de rest van Status & verbruik.