SMS dokumentation

Hos SMSmobileAPI stræber vi efter at gøre vores API så kompatibel som muligt med enhver arkitektur eller platform.
Uanset om du bruger REST, SOAP, cURL eller forskellige programmeringssprog som Python, JavaScript, PHP og mere, er vores API designet til problemfrit at integreres i dine projekter.

Vi har også klar-til-brug plugins til e-handelsløsninger og software.
Klik her for at opdage dem.

Brug for hjælp? api@smsmobileapi.com

Søge

Send SMS

Dette endepunkt giver dig mulighed for at sende en SMS fra din mobiltelefon.

Slutpunkt:

FÅ STOLPE https://api.smsmobileapi.com/sendsms/

Parametre:

Parameter	Beskrivelse
apikey	Påkrævet Din unikke API-nøgle.
recipients	Påkrævet Modtagerens telefonnummer.
message	Påkrævet Beskeden, der skal sendes (ingen grænse på 160 tegn).
port	Definer den SIM-port, der skal bruges til at sende SMS'en: 1, 2, eller lad det være tomt. Hvis feltet ikke er fyldt, sendes SMS'en automatisk via den tilgængelige SIM-port. Denne parameter er tilgængelig fra Android-versionen 4.1.15.0 og fungerer, når appen er i forgrunden.
shorturl	1 = konverter URL'er til korte links 0 eller tom = ingen konvertering
sIdentifiant	Vælg hvilken tilsluttet telefon der sender SMS'en. Lad feltet stå tomt for den første tilgængelige enhed. Kræver app 3.0.35.3+.
sendwa	1 = send via WhatsApp.
sendsms	1 = send via SMS (standard hvis tom). Indstil til 0 for at blokere SMS.
encrypt_message	ja = modtageren skal bruge en nøgle til at dekryptere. Få flere oplysninger
schedule_timestamp	UNIX-tidsstempel (GMT 0), hvorfra SMS'en skal sendes.

Eksempel på anmodning:

HENT https://api.smsmobileapi.com/sendsms/?apikey=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld

Bemærk: I tilfælde af en leveringsfejl forårsaget af din operatør, forsøger en standardfunktion op til 3 gange at sende den igen.

Eksempel på JSON-svar:

{ "resultat": { "fejl": 0, "sendt": "1", "id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "note": "sendt via mobil", "datetime": "2026-03-20T21:07:44Z", "datetimeLocal": "2026-03-20T22:07:44+01:00", "port": null, "iac_control": "1", "iac_authorized": "1", "send_with_whatsapp": "0", "krypteret": { "status": "0" }, "trial_account": { "status": "0", "sms_sent": 0 } } }

Forklaring af svar:

Felt	Beskrivelse
result.error	0 = ingen fejl. Hvis en anden værdi returneres, mislykkedes anmodningen eller blev blokeret.
result.sent	1 = beskeden er blevet accepteret til afsendelse af mobiltelefonen.
result.id	Unikt meddelelsesidentifikator genereret af API'en. Du kan gemme det til sporing eller logføring.
result.note	Yderligere oplysninger om, hvordan beskeden blev behandlet. Eksempel: sendt via mobil.
result.datetime	UTC-dato/-tidspunkt for API-svaret.
result.datetimeLocal	Lokal dato/tid baseret på mobil- eller serverkonfigurationen.
result.port	SIM-port brugt til afsendelse. Kan være 1, 2, eller nul hvis ikke angivet eller ikke returneret.
result.iac_control	Status for intern API-kontrol. 1 betyder, at anmodningen har bestået interne valideringskontroller.
result.iac_authorized	1 betyder, at API-nøglen er autoriseret til at bruge dette slutpunkt.
result.send_with_whatsapp	1 = beskeden behandles via WhatsApp. 0 = standard SMS-afsendelse.
result.encrypted.status	1 = kryptering aktiveret. 0 = besked sendt uden kryptering.
result.trial_account.status	1 = kontoen er en prøvekonto. 0 = almindelig konto.
result.trial_account.sms_sent	Antal SMS'er, der allerede er sendt fra prøvekontoen, hvor det er relevant.

Et vellykket svar vender normalt tilbage fejl = 0 og sendt = 1.

Gensend en ikke-sendt SMS

Dette slutpunkt giver dig mulighed for at sende en tidligere usendt SMS igen, kun hvis beskeden i øjeblikket har en fejlstatus.

Slutpunkt:

FÅ STOLPE https://api.smsmobileapi.com/resend/

Parametre:

Parameter	Beskrivelse
apikey	Påkrævet Din unikke API-nøgle.
guid	Påkrævet GUID for den besked, der skal sendes igen.

Eksempel på anmodning:

FÅ https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE

Eksempel på JSON-svar:

{ "resultat": { "fejl": "0", "sms": "sendt igen med succes", "forsøg": 1 } }

Forklaring af svar:

Felt	Beskrivelse
result.error	0 = ingen fejl. Anmodningen om at sende igen blev accepteret.
result.sms	Statusmeddelelse returneret af API'en. I dette eksempel bekræfter den, at SMS'en blev sendt igen.
result.attempt	Angiver nummeret på forsøget på at sende igen.

Bemærk: Dette slutpunkt fungerer kun for meddelelser, der har en fejlstatus og er berettigede til at blive sendt igen.

Log over SMS sendt fra API'et

Dette slutpunkt giver dig mulighed for at hente loggen over SMS-beskeder sendt via API'en.

Slutpunkt:

FÅ https://api.smsmobileapi.com/log/sent/sms/

Parametre:

Parameter	Beskrivelse
apikey	Påkrævet Din unikke API-nøgle.
guid_message	Filtrer efter det unikke meddelelses-id.
before	Hent beskeder sendt før denne værdi. Afhængigt af din implementering kan dette være et tidsstempel eller en beskedreference.
error_api	1 = kun angiver SMS-beskeder med en API-anmodningsfejl.
error_mobile	1 = kun angiv SMS-beskeder med en mobilbehandlingsfejl.
keyword	Filtrer efter modtagernummer eller beskedindhold.

Eksempel på anmodning:

HENT https://api.smsmobileapi.com/log/sent/sms/?apikey=YOUR_API_KEY

Eksempel på JSON-svar:

{ "resultat": { "fejl": "0", "sms": [ { "sIdentifiantPhone": "abbg00055x5", "port": 0, "date_add": "2026-03-20", "hour_add": "22:07:44", "timestamp": 1774044464, "send_from_mobile": 1, "send_from_mobile_date": "2026-03-20", "send_from_mobile_houre": "22:10:05", "send_from_mobile_timestamp": 1774044605, "modtagere": "32495898697", "sms": "test", "error_api": "", "send_from_mobile_erreur": "", "guid_message": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "timearea": "UTC+01", "date_add_server": "2026-03-20", "hour_add_server": "21:07:44", "timestamp_server": 1774040864, "send_from_mobile_date_server": "2026-03-20", "send_from_mobile_heure_server": "21:10:05" } ] } }

Forklaring af svar:

Felt	Beskrivelse
result.error	0 = ingen fejl. Anmodningen blev behandlet.
result.sms	Array, der indeholder de sendte SMS-logposter, der returneres af API'en.
result.sms[].sIdentifiantPhone	Identifikator for den telefon, der bruges til afsendelse, når tilgængelig.
result.sms[].port	SIM-porten bruges til at sende SMS'er.
result.sms[].date_add	Lokal dato, hvor SMS'en blev føjet til køen.
result.sms[].hour_add	Lokal tid, hvor SMS'en blev føjet til køen.
result.sms[].timestamp	UNIX-tidsstempel for den lokale dato/klokkeslæt i kø.
result.sms[].send_from_mobile	1 = SMS'en blev sendt fra mobilen. 0 = ikke sendt endnu eller mislykkedes før afsendelse.
result.sms[].send_from_mobile_date	Lokal dato, hvor mobilen rent faktisk sendte SMS'en.
result.sms[].send_from_mobile_heure	Lokal tid, hvornår mobilen rent faktisk sendte SMS'en.
result.sms[].send_from_mobile_timestamp	UNIX-tidsstempel for det faktiske afsendelsestidspunkt fra mobilen.
result.sms[].recipients	Modtagerens telefonnummer.
result.sms[].sms	Indholdet af beskeden.
result.sms[].error_api	Fejl returneret under API-anmodningsbehandling, hvis der er nogen. Tom betyder ingen API-fejl.
result.sms[].send_from_mobile_erreur	Fejl returneret af mobilen under afsendelse, hvis der er nogen. Tom betyder ingen mobilfejl.
result.sms[].guid_message	Unikt meddelelses-GUID.
result.sms[].timearea	Tidszone brugt til de lokale dato- og tidsfelter.
result.sms[].date_add_server	Serversidedato, hvor SMS'en blev tilføjet.
result.sms[].hour_add_server	Serversidetidspunkt, hvor SMS'en blev tilføjet.
result.sms[].timestamp_server	UNIX-tidsstempel på serversiden, hvornår SMS'en blev tilføjet.
result.sms[].send_from_mobile_date_server	Serversidedato, hvornår SMS'en blev sendt af mobilen.
result.sms[].send_from_mobile_heure_server	Serversidetidspunkt, hvornår SMS'en blev sendt af mobilen.

Et vellykket svar vender normalt tilbage fejl = 0 og en liste over poster indeni resultat.sms.

Liste over sendte SMS'er fra mobil

Dette slutpunkt giver dig mulighed for at liste SMS-beskeder sendt fra din mobilenhed og synkroniseret med din SMSMobileAPI-konto.

Vigtig: Denne funktion er tilgængelig fra Android-versionen 4.1.20.

Vigtig: Denne funktion er ikke aktiveret som standard i Android-appen.

Privatliv: Alle synkroniserede oplysninger er anonymiserede, fortrolige og håndteres sikkert.

Historikgrænse: Denne API returnerer kun data fra den sidste 7 dage.

Note: Hvis du sender SMS ved hjælp af standard API-slutpunktet https://api.smsmobileapi.com/sendsms/Disse SMS'er kan også vises i denne liste, fordi de fysisk sendes fra din mobilenhed.

Slutpunkt:

FÅ STOLPE https://api.smsmobileapi.com/log/sent/frommobile/

Parametre:

Parameter	Beskrivelse
apikey	Påkrævet Din unikke API-nøgle.
date	Valgfrit. Filter for præcis dato i YYYY-MM-DD format.
date_from	Valgfrit. Periodens startdato i YYYY-MM-DD format.
date_to	Valgfrit. Slutdato for perioden i YYYY-MM-DD format.
period	Valgfrit. Foruddefineret periodefilter. Tilladte værdier: today, yesterday, last_24h, last_3days, last_7days.
number	Valgfrit. Filtrer efter modtagerens telefonnummer.
sIdentifiant	Valgfrit. Filtrer efter mobil-id.
message	Valgfrit. Filtrer efter SMS-indhold.
search	Valgfrit. Global søgning aktiveret sIdentifiant, number, message, mobile_date_formatted, og synchro_time.
sort_by	Valgfrit. Sorteringsfelt. Tilladte værdier: sIdentifiant, number, message, mobile_date_ms, mobile_date_formatted, synchro_time.
sort_order	Valgfrit. Sorteringsrækkefølge: ASC eller DESC.
limit	Valgfrit. Maksimalt antal returnerede rækker. Maksimalt tilladt værdi: 200.

Returnerede felter:

Felt	Beskrivelse
sIdentifiant	Mobilidentifikator knyttet til den sendte SMS.
number	Modtagerens telefonnummer.
message	SMS-indhold.
mobile_date_ms	Oprindeligt SMS-tidsstempel i millisekunder.
mobile_date_formatted	Formateret dato modtaget fra mobilenheden.
synchro_time	Dato og klokkeslæt, hvor SMS'en blev synkroniseret med SMSMobileAPI.

Eksempel på anmodning:

HENT https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY

Eksempel med filtre:

HENT https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY&date=2026-03-13&number=+15551234567&sort_by=synchro_time&sort_order=DESC

Eksempel med foruddefineret periode:

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

Eksempel på JSON-svar:

{ "resultat": { "fejl": "0", "antal": 200, "limit": 200, "history_limit_days": 7, "sort_by": "mobile_date_ms", "sort_order": "DESC", "sms": [ { "sIdentifiant": "508b004b4aadacc4", "number": "+15551234567", "message": "Hej, din aftale er blevet bekræftet.", "mobile_date_ms": 1774041004692, "mobile_date_formatted": "2026-03-20 22:10:04", "synchro_time": "2026-03-20 21:10:05" }, { "sIdentifiant": "e5b70a8a28b2ec3d", "number": "+447700900123", "message": "Din bekræftelseskode er 482915.", "mobile_date_ms": 1774040902284, "mobile_date_formatted": "2026-03-20 22:08:22", "synchro_time": "2026-03-20 21:08:35" }, { "sIdentifiant": "e5b70a8a28b2ec3d", "number": "+33198765432", "message": "Tak for din ordre. Den behandles nu.", "mobile_date_ms": 1774026491230, "mobile_date_formatted": "2026-03-20 18:08:11", "synchro_time": "2026-03-20 17:19:19" } ] } }

Forklaring af svar:

Felt	Beskrivelse
result.error	0 = ingen fejl. Anmodningen blev behandlet.
result.count	Antal SMS-poster returneret i det aktuelle svar.
result.limit	Maksimalt antal rækker, der anmodes om eller anvendes af API'en.
result.history_limit_days	Maksimalt historikinterval tilgængeligt via dette slutpunkt, i dage.
result.sort_by	Sorteringsfelt anvendt på svaret.
result.sort_order	Sorteringsretning anvendt på svaret: ASC eller BESKRIVELSE.
result.sms	Array, der indeholder de synkroniserede SMS-poster sendt fra mobilenheden.
result.sms[].sIdentifiant	Identifikator for den mobile enhed, der sendte SMS'en.
result.sms[].number	Modtagerens telefonnummer.
result.sms[].message	Indholdet af SMS-beskeden.
result.sms[].mobile_date_ms	Oprindeligt mobiltidsstempel i millisekunder.
result.sms[].mobile_date_formatted	Menneskeligt læsbar dato og klokkeslæt fra mobilenheden.
result.sms[].synchro_time	Dato og klokkeslæt, hvor SMS-posten blev synkroniseret med SMSMobileAPI.

Et vellykket svar vender normalt tilbage fejl = 0 og en liste over poster indeni resultat.sms.

SMS modtaget

Dette slutpunkt giver dig mulighed for at hente SMS-beskeder modtaget på smartphonen.

Slutpunkt:

FÅ https://api.smsmobileapi.com/getsms/

Parametre:

Parameter	Beskrivelse
apikey	Påkrævet Din unikke API-nøgle.
sIdentifiantPhone	Valgfrit. Filtrer beskeder modtaget på en bestemt tilknyttet telefon.
after_timestamp_unix	Valgfrit. Hent kun SMS'er modtaget efter et givet UNIX-tidsstempel.
onlyunread	ja = returner kun beskeder, der endnu ikke er markeret som læst af API-status.

Eksempel på anmodning:

HENT https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY

Eksempel på JSON-svar:

{ "resultat": { "fejl": "", "sms": [ { "id": 466340, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "dato": "2026-03-20", "time": "21:23:34", "timestamp_unix": 1774041814, "time_received": "20260320222332804", "indice": "27593", "besked": "Hej, din pakke er blevet leveret.", "nummer": "+15551234567", "guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122", "alias": null, "apikey": "DIN_API_KEY_HASH" }, { "id": 466341, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:23:34", "timestamp_unix": 1774041814, "time_received": "20260320221005892", "indice": "27591", "message": "Din aftale er bekræftet til i morgen.", "number": "+447700900123", "guid": "BF3B38D7-8401-4A8C-8BA6-D8D58ACBB23E", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466324, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:08:24", "timestamp_unix": 1774040904, "time_received": "20260320220822763", "indice": "27590", "message": "Ring venligst tilbage, når det er muligt.", "number": "+33198765432", "guid": "08C88E20-9B98-453F-B361-9BB06D3275D6", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466156, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "time": "19:05:22", "timestamp_unix": 1774033522, "time_received": "20260320200026246", "indice": "27588", "message": "Påmindelse: din kontogennemgang afventer.", "number": "10001", "guid": "551B2CF4-9330-4DD2-B2BA-5A4026EEEB15", "alias": null, "apikey": "YOUR_API_KEY_HASH" } ] } }

Forklaring af svar:

Felt	Beskrivelse
result.error	En tom værdi betyder normalt, at der ikke blev returneret nogen fejl af API'en.
result.sms	Array, der indeholder de modtagne SMS-poster.
result.sms[].id	Intern unik identifikator for den modtagne SMS-post.
result.sms[].sIdentifiantPhone	Identifikator for den telefon, der modtog SMS'en.
result.sms[].date	Dato hvor SMS'en blev modtaget.
result.sms[].hour	Tidspunkt, hvor SMS'en blev modtaget.
result.sms[].timestamp_unix	UNIX-tidsstempel for den modtagne SMS.
result.sms[].time_received	Oprindeligt internt modtagelsestidsstempel leveret af mobilen/appen.
result.sms[].indice	Internt meddelelsesindeks eller reference fra synkroniseringsprocessen.
result.sms[].message	Indholdet af den modtagne SMS.
result.sms[].number	Afsenderens telefonnummer eller shortcode.
result.sms[].guid	Unikt GUID tildelt den modtagne SMS.
result.sms[].alias	Valgfrit alias tilknyttet afsenderen, hvis tilgængeligt. Kan være nul.
result.sms[].apikey	API-nøgle tilknyttet meddelelsesposten. I dokumentationseksempler skal denne værdi maskeres.

Et vellykket svar returnerer normalt et tomt felt fejl værdi og en liste over poster indeni resultat.sms.

Markér modtagede SMS-beskeder som læst

Dette API-slutpunkt bruges til at markere en modtaget SMS-besked som læst i Kun API-status.
Dette ændrer ikke læsestatussen på smartphonen.

Slutpunkt:

FÅ https://api.smsmobileapi.com/getsms/set-read/

Parameter:

Parameter	Beskrivelse
apikey	Påkrævet API-nøglen du har eller vil modtage.
guid_message	Påkrævet GUID for den besked, der skal markeres som læst.

Eksempel:

HENT https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_APIKEY&guid_message=GUID_MESSAGE

Opdater SMS-alias

Dette API-slutpunkt bruges til at opdatere aliaset for en modtaget SMS ved hjælp af dets GUID.

Note: De alias Parameteren kan være tom. I så fald vil aliasset blive slettet.

Slutpunkt:

FÅ STOLPE https://api.smsmobileapi.com/getsms/update/

Parametre:

Parameter	Beskrivelse
apikey	Påkrævet Din API-nøgle.
guid	Påkrævet GUID for den modtagne SMS, der skal opdateres.
alias	Påkrævet Alias, der skal tildeles denne SMS. Denne værdi kan være tom for at slette det aktuelle alias.

Eksempel:

HENT https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE&alias=JohnDoe

Eksempel på at slette aliaset:

HENT https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE&alias=

Slet SMS

Dette slutpunkt giver dig mulighed for at slette SMS-beskeder fra SMSMobileAPI-serverloggen.

Slutpunkt:

FÅ https://api.smsmobileapi.com/deletesms/

Parametre:

Parameter	Beskrivelse
apikey	Påkrævet Din unikke API-nøgle.
guid_message	Slet en bestemt besked ved hjælp af dens unikke besked-GUID.
date_start	Hvis den bruges alene, slettes alle loggede beskeder fra den angivne dato.
date_end	Bruges sammen med startdato at slette beskeder inden for et bestemt datointerval.

Eksempel på anmodning:

HENT https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY&guid_message=GUID_OF_THE_MESSAGE

Eksempel på JSON-svar:

{ "resultat": { "fejl": null, "tælling_slet": 1 } }

Forklaring af svar:

Felt	Beskrivelse
result.error	nul betyder, at API'en ikke returnerede nogen fejl under sletningsanmodningen.
result.count_delete	Antal SMS-logposter slettet fra serveren.

Bemærk: Kun SMS'er, der er gemt i SMSMobileAPI-serverlogfilerne, slettes. SMS-beskeder, der allerede er gemt på mobilenheden, slettes ikke.

Liste over SMS-samtaler

Dette API-slutpunkt bruges til at liste SMS-samtaler, der er knyttet til din konto.

Hver samtale er grupperet efter telefonnummer og indeholder de relaterede indgående og udgående SMS-beskeder.

Note: Samtalens udgangspunkt er defineret af origineConversation parameter:

receivedsamtaler registreres først fra modtagne SMS'er i logsmsreceive
sentsamtaler registreres først fra sendte SMS'er i logsmssent

Note: Hvis numero ikke angivet, returnerer API'en kun de seneste samtaler. Som standard er den sidste 20 samtaler returneres.

Note: For udgående SMS, hvis timearea_of_message er tilgængelig (eksempel: UTC+02), konverteres den viste dato automatisk ved hjælp af denne værdi. Denne konverterede dato bruges også til sortering.

Note: Hvis resume=1, returneres kun de seneste beskeder fra hver samtale. Brug resume_line_how for at definere, hvor mange seneste beskeder der skal inkluderes.

Slutpunkt:

FÅ STOLPE https://api.smsmobileapi.com/conversation/sms/list/

Parametre:

Parameter	Beskrivelse
apikey	Påkrævet Din API-nøgle.
origineConversation	Påkrævet Definerer startpunktet for samtalelisten. Tilladte værdier: received eller sent.
numero	Valgfri Filtrer resultatet kun for ét specifikt telefonnummer.
date_from	Valgfri Startdatofilter for samtaler og beskeder. Accepteret format: YYYY-MM-DD eller en fuld dato- og klokkeslætsværdi.
date_to	Valgfri Slutdatofilter for samtaler og beskeder. Accepteret format: YYYY-MM-DD eller en fuld dato- og klokkeslætsværdi.
sort	Valgfri Sorteringsrækkefølge for samtaler. Tilladte værdier: DESC eller ASCStandard: DESC.
limit	Valgfri Maksimalt antal samtaler, der skal returneres, når numero er ikke angivet. Standard: 20.
resume	Valgfri Hvis indstillet til 1, returneres kun de seneste beskeder fra hver samtale.
resume_line_how	Valgfri Antal seneste beskeder, der skal returneres pr. samtale, når resume=1Standard: 1.

Adfærdsdetaljer:

Indgående SMS'er læses fra logsmsreceive.
Udgående SMS'er læses fra logsmssent.
Indgående beskeder returneres altid direction = "incoming".
Udgående beskeder returneres altid direction = "outgoing".
Kontaktaliasset er taget fra logsmsreceive.alias når tilgængelig.
For indgående SMS kommer mobil-SID'en fra sIdentifiant_pour_read.
For udgående SMS kommer mobil-SID'en fra send_from_mobile_sIdentifiant.
For udgående SMS justeres den viste dato med timearea_of_message hvis dette felt ikke er tomt.

Eksempel 1 - Liste over de seneste samtaler fra modtagne SMS'er:

HENT https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received

Eksempel 2 - Liste over de seneste samtaler fra sendte SMS'er:

HENT https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=sent

Eksempel 3 - Filtrer ét specifikt telefonnummer:

HENT https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&numero=32470000001

Eksempel 4 - Filtrer efter datointerval:

HENT https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&date_from=2026-03-01&date_to=2026-03-31

Eksempel 5 - Genoptag tilstand med de sidste 3 beskeder pr. samtale:

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

Eksempel på vellykket svar:

{ "success": true, "origineConversation": "modtaget", "resume": 0, "resume_line_how": null, "conversations": [ { "phone_number": "+10470000001", "contact_alias": "John Doe", "messages": [ { "direction": "indgående", "message_id": "msg_1001", "date": "2026-03-13 08:45:12", "timestamp_utc": "2026-03-13T08:45:12Z", "message": "Hej, jeg vil gerne have mere information.", "status": "modtaget", "mobile_sid": "device_sid_1" }, { "direction": "udgående", "message_id": "msg_1002", "date": "2026-03-13 "10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "Selvfølgelig, hvad vil du gerne vide?", "status": "sendt", "mobile_sid": "device_sid_2" } ] } ] }

Svarfelter:

Felt	Beskrivelse
success	Angiver om anmodningen var vellykket.
origineConversation	Den starttilstand, der bruges til at opbygge samtalelisten.
resume	Angiver om genoptagelsestilstand er aktiveret.
resume_line_how	Antal seneste linjer returneret pr. samtale, når genoptagelsestilstand er aktiveret.
conversations	Række af samtaler.
phone_number	Telefonnummer brugt til at identificere samtalen.
contact_alias	Alias knyttet til telefonnummeret, når det er tilgængeligt.
messages	En række SMS-beskeder i samtalen.
direction	incoming for modtaget SMS, outgoing for sendte SMS'er.
message_id	Unik identifikator for beskeden.
date	Visningsdato for beskeden. For udgående SMS kan denne værdi justeres ved hjælp af timearea_of_message.
timestamp_utc	UTC-tidsstempel for beskeden.
message	Beskedens indhold.
status	received for indgående SMS'er, sent til udgående SMS'er.
mobile_sid	SID'et for den mobile enhed, der modtog eller sendte beskeden.

Eksempel på fejl:

{ "success": false, "error": "Mangler obligatorisk parameter: apikey" }

Noter:

Hvis numero leveres, returnerer API'en kun den samtale, der er knyttet til dette telefonnummer.
Hvis numero ikke angives, returnerer API'en de seneste samtaler i henhold til den valgte oprindelsestilstand.
Indgående og udgående beskeder samles i en enkelt tidslinje for hvert telefonnummer.
Sortering af udgående beskeder tager højde for den justerede lokale dato, når timearea_of_message er tilgængelig.
Genoptagelsestilstand er nyttig til dashboards, widgets, forhåndsvisninger og samtaleopsummeringer.

Gateway – Liste over tilsluttede mobiltelefoner

Liste over mobiltelefoner, der er forbundet til din SMS Gateway.

Slutpunkt:

FÅ STOLPE https://api.smsmobileapi.com/gateway/mobile/list/

Parametre:

Parameter	Beskrivelse
apikey	Påkrævet Din API-nøgle.
sid	Filtrer efter præcist SID (sIdentifiant_pour_check).
search	Søg i felter (sid, dato, batteri, version, etiket...).

Eksempel:

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

Bemærk: Statistik over modtagne SMS'er er tilgængelig fra version 3.0.33.3+ af mobilappen.

Gateway – Opdater en mobil etiket

Opdater etiketten (nom_reference) for en tilsluttet mobil.

Slutpunkt:

FÅ STOLPE https://api.smsmobileapi.com/gateway/mobile/update/

Parametre:

Parameter	Beskrivelse
apikey	Påkrævet Din API-nøgle.
sid	Påkrævet Enhedens SID (sIdentifiant_pour_check).
label	Ny etiket
phone_number	Nyt telefonnummer

Eksempel:

HENT https://api.smsmobileapi.com/gateway/mobile/update/?apikey=YOUR_API_KEY&sid=SID&label=OfficePhone

Vigtig: etiket er påkrævet, men kan være tomt (etiket=).

Gateway – Slet en tilsluttet mobil

Fjern en tilsluttet mobil fra din gateway (sletter alle historikrækker for dette SID).

Slutpunkt:

FÅ STOLPE https://api.smsmobileapi.com/gateway/mobile/delete/

Parametre:

Parameter	Beskrivelse
apikey	Påkrævet Din API-nøgle.
sid	Påkrævet Enhedens SID (sIdentifiant_pour_check).

Eksempel:

HENT https://api.smsmobileapi.com/gateway/mobile/delete/?apikey=YOUR_API_KEY&sid=SID

Webhook – SMS modtaget

Dette webhook-system sender en POST-anmodning til den konfigurerede URL, hver gang der modtages en SMS. Systemet sikrer opdateringer i realtid ved at levere SMS-detaljerne til den angivne webhook-URL.

Sådan konfigurerer du Webhook i Dashboard

Følg disse trin for at konfigurere din webhook-URL i betjeningspanelet:

Log ind på din konto på SMS Mobile API Dashboard.
Naviger til Webhook-indstillinger afsnit.
Indtast din webhook-URL (f.eks. https://example.com/webhook-endpoint).
Klik på Gem Webhook knap.
Når det er gemt, begynder systemet at sende SMS-detaljer til den konfigurerede URL.

Webhook nyttelast

Når en SMS modtages, sender systemet følgende JSON-nyttelast til din webhook-URL:

{ "dato": "2025-01-20", "time": "10:15:00", "time_received": "2025-01-20 10:14:50", "besked": "Hej, dette er en test.", "nummer": "+123456789", "guid": "abcde12345" }

Nyttelastfelter:

dato: Dato, hvor SMS'en blev tilføjet (ÅÅÅÅ-MM-DD).
time: Time, hvor SMS'en blev tilføjet (TT:mm:ss).
tid_modtaget: Tidspunkt, hvor SMS'en blev modtaget.
besked: Indholdet af SMS'en.
antal: Afsenderens telefonnummer.
guide: Unik identifikator for SMS'en.

Eksempel Webhook Endpoint

Din server bør være klar til at håndtere indgående POST-anmodninger. Nedenfor er et eksempel på et PHP-script til at behandle webhook-nyttelasten:

Test af Webhook

For at teste din webhook-konfiguration skal du bruge værktøjer som:

Fejlfinding

Sørg for, at webhook-URL'en er korrekt og offentligt tilgængelig.
Bekræft, at din server returnerer en HTTP 200-statuskode for vellykkede anmodninger.
Tjek dine serverlogfiler for eventuelle fejl under behandling af nyttelasten.

Beriget SMS

Kommer snart

Autentificering

SMSMobile API understøtter to godkendelsesmetoder: Brug af en simpel API-nøgle eller OAuth2-protokollen med et klient-id og klienthemmelighed.

1. API-nøglegodkendelse

Denne metode kræver en API-nøgle, der kan inkluderes som en parameter i enten en GET- eller POST-anmodning.

2. OAuth2-godkendelse

OAuth2 tilbyder en mere sikker godkendelsesmetode.
Brug et klient-ID og en klienthemmelighed til at hente et adgangstoken, og inkluder det derefter i Bemyndigelse overskrift.

Client_id og client_secret er tilgængelige i dit dashboard.
Download mobilappen nu eller få adgang til dit dashboard.

Få et adgangstoken


curl -X POST https://api.smsmobileapi.com/oauth2/token \

-H "Content-Type: application/x-www-form-urlencoded" \

-d "grant_type=client_credentials" \

-d "client_id=YOUR_CLIENT_ID" \

-d "client_secret=YOUR_CLIENT_SECRET"

Brug af adgangstoken:


curl -X POST https://api.smsmobileapi.com/sendsms \

-H "Autorisation: Bærer YOUR_ACCESS_TOKEN" \

-H "Content-Type: application/x-www-form-urlencoded" \

-d "recipients=+1234567890" \

-d "meddelelse=Hej"

Hvilken metode skal du bruge?

- Brug API-nøglegodkendelse til hurtige og ligetil integrationer.

- Brug OAuth2-godkendelse for forbedret sikkerhed og skalerbarhed.

Send SMS

WSDL URL

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

Parametre:

- recipients: Mobilnummeret på modtageren.
- message: Beskeden der skal sendes.
- apikey: API-nøglen du har eller vil modtage.

Eksempel


require_once "lib/nusoap.php";


$client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);

$error  = $client->getError();


$result = $client->call("sendSms", array("recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));


print_r($result);

Send SMS og WhatsApp

Grundlæggende cURL-kommando


curl -X POST https://api.smsmobileapi.com/sendsms/ \

-d "recipients=PHONE_NUMBER" \

-d "message=YOUR_MESSAGE" \

-d "apikey=YOUR_API_KEY" 

-d "sendwa=1"

-d "sendsms=1"

Send SMS og WhatsApp

Brug vores officielle Python-modul: https://smsmobileapi.com/python/


import requests


url = "https://api.smsmobileapi.com/sendsms/"


payload = {"recipients":"PHONE_NUMBER","message":"YOUR_MESSAGE","apikey":"YOUR_API_KEY"}


response = requests.post(url, data=payload)

print(response.text)

SMS Mobile API - PHP SDK (komponist)

komponist kræver smsmobileapi/sdk

GitHub: https://github.com/SmsMobileApi/smsmobileapi-php/tree/main

Send SMS og WhatsApp


const url = "https://api.smsmobileapi.com/sendsms/";

const data = {recipients:"PHONE_NUMBER", message:"YOUR_MESSAGE", apikey:"YOUR_API_KEY"};

fetch(url,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams(data)})

.then(r=>r.text()).then(console.log);

Send SMS og WhatsApp


const axios = require("axios");

axios.post("https://api.smsmobileapi.com/sendsms/", {recipients:"PHONE_NUMBER", message:"YOUR_MESSAGE", apikey:"YOUR_API_KEY"})

.then(r=>console.log(r.data));

Send SMS og WhatsApp


require "net/http"

require "uri"

uri = URI.parse("https://api.smsmobileapi.com/sendsms/")

req = Net::HTTP::Post.new(uri)

req.set_form_data({"recipients"=>"PHONE_NUMBER","message"=>"YOUR_MESSAGE","apikey"=>"YOUR_API_KEY"})

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true){|http| http.request(req)}

puts res.body

Klik her for at teste API-nøglen og tjenesten med den enkle formular

Afhængigt af versionen af Android, der er installeret på en mobiltelefon, kan operativsystemet hindre den korrekte funktion af automatisk afsendelse og modtagelse af SMS-beskeder, når SmsMobileApi-applikationen ikke er i forgrunden.
Dette problem opstår fra en proces, der forsøger at køre i baggrunden, når applikationen ikke aktivt startes. Men på grund af Androids batterioptimeringsforanstaltninger, som varierer på tværs af forskellige versioner, starter denne baggrundsproces muligvis ikke korrekt. Androids batterioptimering er designet til at begrænse baggrundsaktiviteten af apps for at spare batterilevetid, hvilket utilsigtet kan påvirke apps, der kræver baggrundsprocesser for at fungere korrekt.

For at løse dette problem kan brugere manuelt konfigurere deres Android-indstillinger for at tillade SmsMobileApi at bruge ressourcer uden begrænsninger.
Dette involverer justering af batterioptimeringsindstillingerne for den specifikke app, i det væsentlige at instruere Android om, at SmsMobileApi har tilladelse til at køre i baggrunden og bruge ressourcer efter behov. Ved at gøre det bør applikationen automatisk kunne sende og modtage SMS-beskeder, selv når den ikke er den aktive applikation i forgrunden. Denne justering sikrer, at den nødvendige baggrundsproces kan fungere uafbrudt, og omgå batterioptimeringsfunktionerne, der ellers kunne forhindre dens korrekte udførelse.

FAQ for udviklere

Hvordan genererer man en API-nøgle?

Harmonika-eksempelbeskrivelse For at generere en API-nøgle skal du downloade vores applikation til din mobiltelefon og oprette en konto uden omkostninger. En API-nøgle vil automatisk blive genereret og knyttet til din mobiltelefon. Du vil også modtage en e-mail med alle nødvendige oplysninger. Denne proces sikrer, at du hurtigt og nemt kan begynde at bruge vores tjenester med minimal opsætning.

Hvor kan jeg altid finde min API-nøgle?

I din mobilapplikation skal du navigere til menuen INDSTILLINGER eller HJÆLP, hvor din API-nøgle er synlig hele tiden. Dette sikrer, at du nemt kan få adgang til din API-nøgle, når du har brug for den til at integrere eller bruge vores tjenester.

Kan oprettelsen af en API-nøgle være anonym?

Ja, vi kræver ikke noget bevis på identitet for at oprette en API-nøgle. Kommunikationen mellem vores API og din mobiltelefon er derfor 100% anonym. Denne tilgang giver brugerne mulighed for at bevare deres privatliv, mens de bruger vores tjenester.

Kom godt i gang med SMSmobileAPI i dag!

Oplev friheden og fleksibiliteten ved at administrere dine SMS-tjenester på farten. Download vores mobilapp nu og tag det første skridt mod problemfri SMS-integration.

Download appen

API og udviklerdokumenter

Værktøjer og ændringer log

Send SMS

Slutpunkt:

Parametre:

Eksempel på anmodning:

Eksempel på JSON-svar:

Forklaring af svar:

Gensend en ikke-sendt SMS

Slutpunkt:

Parametre:

Eksempel på anmodning:

Eksempel på JSON-svar:

Forklaring af svar:

Log over SMS sendt fra API'et

Slutpunkt:

Parametre:

Eksempel på anmodning:

Eksempel på JSON-svar:

Forklaring af svar:

Liste over sendte SMS'er fra mobil

Slutpunkt:

Parametre:

Returnerede felter:

Eksempel på anmodning:

Eksempel med filtre:

Eksempel med foruddefineret periode:

Eksempel på JSON-svar:

Forklaring af svar:

SMS modtaget

Slutpunkt:

Parametre:

Eksempel på anmodning:

Eksempel på JSON-svar:

Forklaring af svar:

Markér modtagede SMS-beskeder som læst

Slutpunkt:

Parameter:

Eksempel:

Opdater SMS-alias

Slutpunkt:

Parametre:

Eksempel:

Eksempel på at slette aliaset:

Slet SMS

Slutpunkt:

Parametre:

Eksempel på anmodning:

Eksempel på JSON-svar:

Forklaring af svar:

Liste over SMS-samtaler

Slutpunkt:

Parametre:

Adfærdsdetaljer:

Eksempel 1 - Liste over de seneste samtaler fra modtagne SMS'er:

Eksempel 2 - Liste over de seneste samtaler fra sendte SMS'er:

Eksempel 3 - Filtrer ét specifikt telefonnummer:

Eksempel 4 - Filtrer efter datointerval:

Eksempel 5 - Genoptag tilstand med de sidste 3 beskeder pr. samtale:

Eksempel på vellykket svar:

Svarfelter:

Eksempel på fejl:

Noter:

Gateway – Liste over tilsluttede mobiltelefoner

Slutpunkt:

Parametre:

Eksempel:

Gateway – Opdater en mobil etiket

Slutpunkt:

Parametre:

Eksempel:

Gateway – Slet en tilsluttet mobil

Slutpunkt:

Parametre:

Eksempel:

Webhook – SMS modtaget

Sådan konfigurerer du Webhook i Dashboard

Webhook nyttelast

Nyttelastfelter:

Eksempel Webhook Endpoint