Start hier

Uw eerste verzoek in vier stappen

Maak een account aan en kopieer de API-toets van het dashboard.

Installeer de mobiele app en bevestig dat het apparaat online is.

Stuur één test SMS met het /sendms/eindpunt.

Bewaar de geretourneerde bericht ID om logs en leveringsstatus te correleren.

De veilige SMSMobileAPI mobiele app die een telefoon verbindt met het webdashboard en REST API voor SMS- en oproepoperaties — Versleutelde mobiele-naar-platformverbinding

Officiële mobiele applicatie

De veilige brug tussen uw telefoon, dashboard en API.

SMS- en oproepoperaties gaan door via de officiële SMSMobileAPI-app die op uw aangesloten telefoon is geïnstalleerd. De app koppelt het apparaat veilig met uw account, synchroniseert geautoriseerde evenementen en koppelt het mobiele netwerk aan het dashboard en REST API.

1Mobiele appVergelijkt de telefoon en de SIM 2Versleutelde verwijzingAuthenticeert en beschermt gegevens tijdens de doorvoer 3Dashboard & APIControleert workflows en activiteit

Ondertekende releases verspreid via de officiële Google Play en Apple App Store lijsten
Google en Apple platform review, ondertekening en distributie controles
Veilige apparaat koppeling, HTTPS transport en geauthentiseerde API toegang
Alleen de rechten die nodig zijn voor de mobiele functies die u aanroept

Ontvang de officiële SMSMobileAPI-app op Google Play

Download de officiële SMSMobileAPI-app in de Apple App Store

Mogelijkheden zijn afhankelijk van de toegangsrechten en achtergrondtoegang die door Android of iOS worden toegestaan.

Authenticatie

Houd referenties op uw server

Elk verzoek accepteert een API-sleutel via de apikey parameter. OAuth2 client-referenties zijn ook beschikbaar voor server-naar-server integraties. Laat nooit een productiesleutel zien in browsercode, openbare repositories of ondersteuningsberichten.

POST · GET

SMS sturen

STOPPLIJThttps://api.smsmobileapi.com/sendsms/

Wacht op een bericht op een verbonden telefoon. POST wordt aanbevolen wanneer het bericht lang is of speciale tekens bevat.

Wanneer moet u het gebruiken?

Gebruik dit voor transactieberichten, herinneringen, waarschuwingen en SMS-programma's.

Parameters

Naam	Type	Vereist	Beschrijving
`apikey`	tekenreeks	Vereist	Uw account API sleutel.
`recipients`	telefoon	Vereist	Nummer van de bestemming in internationaal formaat.
`message`	tekenreeks	Vereist	Bericht lichaam. URL-coderen bij het gebruik van GET.
`port`	1 \| 2	Facultatief	SIM-poort op compatibele Android-apparaten; leeg laten voor automatische selectie.
`sIdentifiant`	tekenreeks	Facultatief	Specifieke verbonden telefoon SID; leeg laten voor het eerste beschikbare apparaat.
`shorturl`	0 \| 1	Facultatief	Instellen op 1 om URL's in te korten die in het bericht voorkomen.
`sendsms`	0 \| 1	Facultatief	SMS kanaal vlag. Standaardwaarde 1 indien weggelaten.
`sendwa`	0 \| 1	Facultatief	Vraag ook WhatsApp levering wanneer het account het ondersteunt.
`encrypt_message`	Ja	Facultatief	Versleutel het bericht voor beschermde lees aan de ontvangerzijde.
`schedule_timestamp`	Unix seconden	Facultatief	UTC-tijd vanaf welke het bericht kan worden verzonden.

Voorbeeld aanvragen

krul

curl -X POST "https://api.smsmobileapi.com/sendsms/" \
  -d "apikey=YOUR_API_KEY" \
  -d "recipients=+1234567890" \
  --data-urlencode "message=Your appointment is confirmed for tomorrow."

Voorbeeldantwoord

JSON

{
  "result": {
    "error": 0,
    "sent": "1",
    "id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25",
    "note": "sent by mobile",
    "datetime": "2026-03-20T21:07:44Z",
    "port": null,
    "send_with_whatsapp": "0"
  }
}

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑

Goed om te weten

Een succesvolle API respons betekent dat het bericht door het platform werd geaccepteerd; houd het geretourneerde id voor later volgen.
Vervoerder levering en mobiele verwerking kan gebeuren na de HTTP reactie.

POST · GET

Een niet-verzonden SMS opnieuw verzenden

STOPPLIJThttps://api.smsmobileapi.com/resend/

Verbreekt een bericht dat zich momenteel in een fouttoestand bevindt.

Wanneer moet u het gebruiken?

Gebruik dit na het controleren van het verzonden logboek en de bevestiging dat een mislukt bericht in aanmerking komt voor een andere poging.

Parameters

Naam	Type	Vereist	Beschrijving
`apikey`	tekenreeks	Vereist	Uw account API sleutel.
`guid`	tekenreeks	Vereist	Het bericht GUID teruggestuurd door het verzenden of log eindpunt.

Voorbeeld aanvragen

krul

curl "https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE"

Voorbeeldantwoord

JSON

{
  "result": {
    "error": "0",
    "sms": "resent with successfully",
    "attempt": 1
  }
}

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑

Goed om te weten

Alleen berichten met een foutstatus kunnen wrok hebben.

KRIJGEN

Lijst SMS verzonden van de API

STOPPLIJThttps://api.smsmobileapi.com/log/sent/sms/

Geeft berichten terug die via de SMS API zijn verzonden met wachtrij, mobiele en foutinformatie.

Wanneer moet u het gebruiken?

Gebruik het voor het toezicht op de levering, ondersteuning van diagnostiek en verzoening.

Parameters

Naam	Type	Vereist	Beschrijving
`apikey`	tekenreeks	Vereist	Uw account API sleutel.
`guid_message`	tekenreeks	Facultatief	Geef één bericht door zijn unieke GUID.
`before`	tijdstempel of verwijzing	Facultatief	Berichten retourneren voordat de opgegeven cursor of tijdstempel wordt opgegeven.
`error_api`	0 \| 1	Facultatief	Stel in op 1 om API alleen verwerkingsfouten terug te geven.
`error_mobile`	0 \| 1	Facultatief	Alleen voor het terugsturen van mobiele foutmeldingen op 1 ingesteld.
`keyword`	tekenreeks	Facultatief	Doorzoek het nummer van de ontvanger of bericht tekst.

Voorbeeld aanvragen

krul

curl "https://api.smsmobileapi.com/log/sent/sms/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

Voorbeeldantwoord

JSON

{
  "result": {
    "error": "0",
    "sms": [{
      "sIdentifiantPhone": "508b004b4aadacc4",
      "recipients": "+1234567890",
      "sms": "Test message",
      "guid_message": "MESSAGE_GUID",
      "send_from_mobile": 1,
      "error_api": "",
      "send_from_mobile_erreur": ""
    }]
  }
}

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑

KRIJGEN

Lijst SMS gesynchroniseerd vanaf een telefoon

STOPPLIJThttps://api.smsmobileapi.com/log/sent/frommobile/

Lijsten SMS fysiek verzonden door een mobiele en gesynchroniseerd met het platform.

Wanneer moet u het gebruiken?

Gebruik het wanneer berichten kunnen ontstaan op de telefoon en via de API.

Parameters

Naam	Type	Vereist	Beschrijving
`apikey`	tekenreeks	Vereist	Uw account API sleutel.
`date`	JJJJ-MM-DD	Facultatief	Filter één exacte datum.
`date_from`	JJJJ-MM-DD	Facultatief	Begin van een datumbereik.
`date_to`	JJJJ-MM-DD	Facultatief	Einde van een datumbereik.
`period`	enum	Facultatief	vandaag, gisteren, laatste 24h, laatste 3 dagen of laatste 7 dagen.
`number`	telefoon	Facultatief	Filter op ontvanger.
`sIdentifiant`	tekenreeks	Facultatief	Filter op verbonden mobiele SID.
`message`	tekenreeks	Facultatief	Filteren op berichtinhoud.
`search`	tekenreeks	Facultatief	Wereldwijde zoekopdrachten op mobiele telefoon, nummer, bericht en tijdstempels.
`sort_by`	enum	Facultatief	sIdentificant, number, message, mobile date ms, mobile date formatted or synchro time.
`sort_order`	ASC	Facultatief	Sorteer richting.
`limit`	geheel getal	Facultatief	Maximaal 200 records.

Voorbeeld aanvragen

krul

curl "https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY&period=last_7days&limit=200"

Voorbeeldantwoord

JSON

{
  "result": {
    "error": "0",
    "count": 1,
    "history_limit_days": 7,
    "sms": [{
      "sIdentifiant": "508b004b4aadacc4",
      "number": "+15551234567",
      "message": "Appointment confirmed.",
      "mobile_date_ms": 1774041004692,
      "synchro_time": "2026-03-20 21:10:05"
    }]
  }
}

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑

Goed om te weten

Vereist Android app 4.1.20 of nieuwer en moet worden ingeschakeld in de app.
Dit eindpunt geeft maximaal zeven dagen gesynchroniseerde geschiedenis terug.

KRIJGEN

Lijst ontvangen SMS

STOPPLIJThttps://api.smsmobileapi.com/getsms/

Geeft inkomende SMS gesynchroniseerd van aangesloten telefoons.

Wanneer moet u het gebruiken?

Gebruik het om een inbox te bouwen, peiling voor antwoorden of berichten te herstellen na een onderbreking van de webhook.

Parameters

Naam	Type	Vereist	Beschrijving
`apikey`	tekenreeks	Vereist	Uw account API sleutel.
`sIdentifiantPhone`	tekenreeks	Facultatief	Filter via de telefoon die de SMS heeft ontvangen.
`after_timestamp_unix`	Unix seconden	Facultatief	Berichten terugsturen die na deze tijdstempel zijn ontvangen.
`onlyunread`	Ja	Facultatief	Alleen berichten retourneren die niet als gelezen zijn gemarkeerd in de status API.

Voorbeeld aanvragen

krul

curl "https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY&onlyunread=yes"

Voorbeeldantwoord

JSON

{
  "result": {
    "error": "",
    "sms": [{
      "id": 466340,
      "sIdentifiantPhone": "508b004b4aadacc4",
      "timestamp_unix": 1774041814,
      "message": "Please call us back.",
      "number": "+15551234567",
      "guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
      "alias": null
    }]
  }
}

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑

POST · GET

Een ontvangen sms als gelezen markeren

STOPPLIJThttps://api.smsmobileapi.com/getsms/set-read/

Markeert een ontvangen bericht als gelezen in SMSMobileAPI API toestand.

Wanneer moet u het gebruiken?

Gebruik dit nadat uw toepassing een inkomende bericht heeft verwerkt.

Parameters

Naam	Type	Vereist	Beschrijving
`apikey`	tekenreeks	Vereist	Uw account API sleutel.
`guid_message`	tekenreeks	Vereist	GIDS van de ontvangen SMS.

Voorbeeld aanvragen

krul

curl "https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑

Goed om te weten

Dit verandert de leesstatus in de telefoonberichtentoepassing niet.

POST · GET

Een ontvangen SMS-alias bijwerken

STOPPLIJThttps://api.smsmobileapi.com/getsms/update/

Voegt, wijzigt of verruimt de alias die verbonden is met een ontvangen SMS.

Wanneer moet u het gebruiken?

Gebruik aliassen om een contactnaam of toepassingslabel aan een bericht te koppelen.

Parameters

Naam	Type	Vereist	Beschrijving
`apikey`	tekenreeks	Vereist	Uw account API sleutel.
`guid`	tekenreeks	Vereist	GIDS van de ontvangen SMS.
`alias`	tekenreeks	Vereist	Nieuwe alias. Stuur een lege waarde om het te wissen.

Voorbeeld aanvragen

krul

curl "https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=MESSAGE_GUID&alias=John%20Doe"

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑

POST · GET

SMS-serverlogboeken verwijderen

STOPPLIJThttps://api.smsmobileapi.com/deletesms/

Verwijdert SMS-records uit het SMSMobileAPI-serverlogboek.

Wanneer moet u het gebruiken?

Gebruik het voor het bewaren van workflows of het verwijderen van een specifiek bericht.

Parameters

Naam	Type	Vereist	Beschrijving
`apikey`	tekenreeks	Vereist	Uw account API sleutel.
`guid_message`	tekenreeks	Facultatief	Een bericht door GUID verwijderen.
`date_start`	JJJJ-MM-DD	Facultatief	Verwijder records vanaf deze datum.
`date_end`	JJJJ-MM-DD	Facultatief	Met date start beperkt u het verwijderingsbereik.

Voorbeeld aanvragen

krul

curl "https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY&guid_message=MESSAGE_GUID"

Voorbeeldantwoord

JSON

{
  "result": {
    "error": null,
    "count_delete": 1
  }
}

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑

Goed om te weten

Dit verwijdert alleen serverlog items. Het verwijdert geen berichten die zijn opgeslagen op het mobiele apparaat.
Behandel deze operatie als destructief en controleer filters voordat u ze aanroept.

KRIJGEN

Lijst met SMS-gesprekken

STOPPLIJThttps://api.smsmobileapi.com/conversation/sms/list/

Inkomende en uitgaande berichten in gesprekken per telefoonnummer groeperen.

Wanneer moet u het gebruiken?

Gebruik het voor chatweergaven, recente gesprekswidgets en ondersteuning van tijdlijnen.

Parameters

Naam	Type	Vereist	Beschrijving
`apikey`	tekenreeks	Vereist	Uw account API sleutel.
`origineConversation`	ontvangen	Vereist	Dataset gebruikt om de startende gesprekken te identificeren.
`numero`	telefoon	Facultatief	Geef één telefoon-nummer gesprek terug.
`date_from`	datum of datum	Facultatief	Begin van het berichtbereik.
`date_to`	datum of datum	Facultatief	Einde berichtbereik.
`sort`	ASC	Facultatief	Gespreksvolgorde; standaard DESC.
`limit`	geheel getal	Facultatief	Gesprekslimiet wanneer numero wordt weggelaten; standaard 20.
`resume`	0 \| 1	Facultatief	Stel in op 1 om alleen de nieuwste berichten per gesprek terug te sturen.
`resume_line_how`	geheel getal	Facultatief	Aantal berichten per gesprek bij hervatten=1.

Voorbeeld aanvragen

krul

curl "https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&resume=1&resume_line_how=3"

Voorbeeldantwoord

JSON

{
  "success": true,
  "origineConversation": "received",
  "conversations": [{
    "phone_number": "+15551234567",
    "contact_alias": "John Doe",
    "messages": [{
      "direction": "incoming",
      "message_id": "msg_1001",
      "timestamp_utc": "2026-03-13T08:45:12Z",
      "message": "I need more information.",
      "status": "received",
      "mobile_sid": "device_sid_1"
    }]
  }]
}

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑

KRIJGEN

Lijst verbonden mobiele telefoons

STOPPLIJThttps://api.smsmobileapi.com/gateway/mobile/list/

Lijsten van telefoons verbonden met het SMS gateway-account.

Wanneer moet u het gebruiken?

Gebruik het om een afzender te selecteren, de status van het apparaat te tonen of een gateway vloot te controleren.

Parameters

Naam	Type	Vereist	Beschrijving
`apikey`	tekenreeks	Vereist	Uw account API sleutel.
`sid`	tekenreeks	Facultatief	Geef één exacte mobiele SID terug.
`search`	tekenreeks	Facultatief	Zoeken SID, datum, batterij, versie, label en gerelateerde velden.

Voorbeeld aanvragen

krul

curl "https://api.smsmobileapi.com/gateway/mobile/list/?apikey=YOUR_API_KEY"

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑

POST · GET

Een verbonden mobiele telefoon bijwerken

STOPPLIJThttps://api.smsmobileapi.com/gateway/mobile/update/

Updates van het menselijk leesbare label of telefoonnummer van een aangesloten apparaat.

Wanneer moet u het gebruiken?

Gebruik het om apparaatlabels zinvol te houden in multi-telefoon installaties.

Parameters

Naam	Type	Vereist	Beschrijving
`apikey`	tekenreeks	Vereist	Uw account API sleutel.
`sid`	tekenreeks	Vereist	Het apparaat SID.
`label`	tekenreeks	Vereist	Nieuw etiket; het kan opzettelijk leeg zijn.
`phone_number`	telefoon	Facultatief	Nieuwe telefoonnummermetadata.

Voorbeeld aanvragen

krul

curl "https://api.smsmobileapi.com/gateway/mobile/update/?apikey=YOUR_API_KEY&sid=DEVICE_SID&label=OfficePhone"

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑

POST · GET

Een verbonden mobiele telefoon verwijderen

STOPPLIJThttps://api.smsmobileapi.com/gateway/mobile/delete/

Verwijdert een verbonden mobiele telefoon en de toegangsgeschiedenis rijen.

Wanneer moet u het gebruiken?

Alleen gebruiken wanneer een telefoon permanent van het account verwijderd moet worden.

Parameters

Naam	Type	Vereist	Beschrijving
`apikey`	tekenreeks	Vereist	Uw account API sleutel.
`sid`	tekenreeks	Vereist	SID van het apparaat te verwijderen.

Voorbeeld aanvragen

krul

curl "https://api.smsmobileapi.com/gateway/mobile/delete/?apikey=YOUR_API_KEY&sid=DEVICE_SID"

Wil je dit verzoek doen?Sluit uw API-toets bovenaan de pagina aan om de interactieve tester te ontgrendelen.

Sleutel verbinden ↑

Goed om te weten

Deze bewerking verwijdert de apparaatgeschiedenis die geassocieerd is met de SID. Bevestig het apparaat voordat je het belt.

GEHANDVOLGST

SMS ontvangen via webhook

BESTEMMINGYour HTTPS endpoint

SMSMobileAPI stuurt een JSON verzoek naar uw geconfigureerde URL wanneer een SMS wordt ontvangen.

Wanneer moet u het gebruiken?

Gebruik webhooks voor real-time verwerking in plaats van frequent peilen.

Voorbeeld van ontvanger

PHP 8

<?php
$payload = json_decode(file_get_contents('php://input'), true);
if (!is_array($payload) || empty($payload['guid'])) {
    http_response_code(400);
    exit('Invalid payload');
}
// Queue the event, then acknowledge quickly.
http_response_code(200);
echo 'OK';

Voorbeeldantwoord

JSON

{
  "date": "2026-03-20",
  "hour": "10:15:00",
  "time_received": "2026-03-20 10:14:50",
  "message": "Hello, this is a test.",
  "number": "+123456789",
  "guid": "abcde12345"
}

Inbound-eindpunt

Dit eindpunt ontvangt gebeurtenissen op uw eigen HTTPS URL. Gebruik het bovenstaande ontvangervoorbeeld en stuur dan een SMS naar uw aangesloten telefoon om het te testen.

Goed om te weten

Configureer de publieke HTTPS URL in Dashboard → Webhook instellingen.
Geef HTTP 200 snel terug en verwerk de gebeurtenis asynchroon.
Dedupliceer opnieuw met behulp van guid.

Problemen oplossen

Fouten en veilige herhalingen

Lees de HTTP status en het JSON foutveld voordat u het opnieuw probeert. Probeer geen validatie of authenticatiefouten opnieuw zonder eerst het verzoek te corrigeren.

HTTP	Rubriek	Wat te doen?
400	`missing_parameter`	Een vereiste parameter is leeg of ontbreekt. Controleer de parametertabel voor het eindpunt.
403	`invalid_apikey`	De API sleutel is onbekend, verlopen of niet toegestaan voor de gevraagde functie.
429	`too_many_requests`	De verzoeken komen te snel. Wacht, probeer het dan opnieuw met exponentiële backoff.
500	`server_error`	De dienst kon het verzoek niet voltooien. Houd de respons en contact ondersteuning als deze aanhoudt.

Regel opnieuw proberenProbeer slechts voorbijgaande 429 en 5xx responsen. Begin na 1 seconde, dan terug naar 2, 4 en 8 seconden.

Hulp nodig?

Breng de context van het verzoek en niet uw geheimen.

Deel het eindpunt, tijdstempel, HTTP status en gesanitiseerde respons. Neem nooit API sleutels, tokens of privé-inhoud van berichten.

Contact API ondersteuning →

SMS-documentatie API

Uw eerste verzoek in vier stappen

De veilige brug tussen uw telefoon, dashboard en API.

Houd referenties op uw server

Parameters

Voorbeeld aanvragen

Voorbeeldantwoord

Parameters

Voorbeeld aanvragen

Voorbeeldantwoord

Parameters

Voorbeeld aanvragen

Voorbeeldantwoord

Parameters

Voorbeeld aanvragen

Voorbeeldantwoord

Parameters

Voorbeeld aanvragen

Voorbeeldantwoord

Parameters

Voorbeeld aanvragen

Parameters

Voorbeeld aanvragen

Parameters

Voorbeeld aanvragen

Voorbeeldantwoord

Parameters

Voorbeeld aanvragen

Voorbeeldantwoord

Parameters

Voorbeeld aanvragen

Parameters

Voorbeeld aanvragen

Parameters

Voorbeeld aanvragen

Voorbeeld van ontvanger

Voorbeeldantwoord

Fouten en veilige herhalingen

Breng de context van het verzoek en niet uw geheimen.