SMS-dokumentaatio

SMSmobileAPI:lla pyrimme tekemään API:sta mahdollisimman yhteensopivan minkä tahansa arkkitehtuurin tai alustan kanssa.
Käytitpä sitten RESTiä, SOAPia, cURL:ää tai useita eri ohjelmointikieliä, kuten Pythonia, JavaScriptiä, PHP:tä ja muita, API:mme on suunniteltu integroitumaan saumattomasti projekteihisi.

Meillä on myös käyttövalmiita laajennuksia verkkokaupan ratkaisuihin ja ohjelmistoihin.
Klikkaa tästä löytääksesi ne.

Tarvitsetko apua? api@smsmobileapi.com

Haku

Lähetä SMS

Tämän päätepisteen avulla voit lähettää tekstiviestin matkapuhelimellasi.

Päätepiste:

SAADA LÄHETTÄÄ https://api.smsmobileapi.com/sendsms/

Parametrit:

Parametri	Kuvaus
apikey	Pakollinen Ainutlaatuinen API-avaimesi.
recipients	Pakollinen Vastaanottajan puhelinnumero.
message	Pakollinen Lähetettävä viesti (ei 160 merkin rajoitusta).
port	Määritä SIM-kortin portti tekstiviestin lähettämistä varten: 1, 2tai jätä se tyhjäksi. Jos jätät tämän tyhjäksi, tekstiviesti lähetetään automaattisesti käytettävissä olevan SIM-kortin portin kautta. Tämä parametri on käytettävissä Android-versiosta alkaen 4.1.15.0 ja toimii, kun sovellus on etualalla (ensimmäinen suunnitelma).
shorturl	1 = muunna URL-osoitteet lyhyiksi linkeiksi 0 tai tyhjä = ei konversiota
sIdentifiant	Valitse, mikä yhdistetty puhelin lähettää tekstiviestin. Jätä tyhjäksi ensimmäisen käytettävissä olevan laitteen kohdalla. Vaatii sovelluksen version 3.0.35.3+.
sendwa	1 = lähetä WhatsAppin kautta.
sendsms	1 = lähetä tekstiviestitse (oletusarvo, jos tyhjä). Aseta arvoksi 0 estääksesi tekstiviestit.
encrypt_message	kyllä = vastaanottaja tarvitsee avaimen salauksen purkamiseen. Lue lisää
schedule_timestamp	UNIX-aikaleima (GMT 0), josta tekstiviesti lähetetään.

Esimerkki:

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

Huomautus: jos operaattorisi aiheuttaa toimitusvirheen, oletustoiminto yrittää uudelleen jopa 3 kertaa.

Lähetä uudelleen lähettämätön tekstiviesti

Tätä API-päätepistettä käytetään lähettämättömän tekstiviestin uudelleenlähettämiseen (vain jos viestillä on virhetila).

Päätepiste:

SAADA LÄHETTÄÄ https://api.smsmobileapi.com/resend/

Parametri:

Parametri	Kuvaus
guid	Pakollinen Uudelleenlähetettävän viestin GUID.

Esimerkki:

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

API:lta lähetetty tekstiviestiloki

Tätä API-päätepistettä käytetään API:n kautta lähetettyjen tekstiviestien lokin hakemiseen.

Päätepiste:

SAADA https://api.smsmobileapi.com/log/sent/sms/

Parametri:

Parametri	Kuvaus
apikey	Pakollinen API-avaimesi.
guid_message	Suodata viestin yksilöllisen tunnisteen mukaan.
before	Hae viestit, jotka on lähetetty ennen tätä aikaleimaa tai GUID:ia.
error_api	1 = listaa tekstiviestit, joissa on API-pyyntövirhe.
error_mobile	1 = Listaa tekstiviestit, joissa on mobiilikäsittelyvirhe.
keyword	Suodata vastaanottajan numeron tai viestin sisällön mukaan.

Esimerkki:

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

Listaa matkapuhelimesta lähetetyt tekstiviestit

Tätä API-päätepistettä käytetään mobiililaitteestasi lähetettyjen ja SMSMobileAPI-tilillesi synkronoitujen tekstiviestien listaamiseen.

Tärkeää: Tämä ominaisuus on käytettävissä Android-versiosta alkaen 4.1.20.

Tärkeää: Tämä ominaisuus on ei oletuksena käytössä Android-sovelluksessa.

Tietosuoja: Kaikki synkronoidut tiedot anonymisoidaan, luottamuksellisina ja käsitellään turvallisesti.

Historiaraja: Tämä API palauttaa aina tiedot viimeisimmästä 7 päivää vain.

Huomautus: Jos lähetät tekstiviestin käyttämällä vakio-API-päätepistettä https://api.smsmobileapi.com/sendsms/, nämä tekstiviestit saattavat näkyä tässä listauksessa myös siksi, että ne lähetetään fyysisesti mobiililaitteestasi.

Päätepiste:

SAADA LÄHETTÄÄ https://api.smsmobileapi.com/log/sent/frommobile/

Parametrit:

Parametri	Kuvaus
apikey	Pakollinen API-avaimesi.
date	Valinnainen. Tarkan päivämäärän suodatin YYYY-MM-DD muoto.
date_from	Valinnainen. Jakson alkamispäivä YYYY-MM-DD muoto.
date_to	Valinnainen. Jakson päättymispäivä YYYY-MM-DD muoto.
period	Valinnainen. Ennalta määritetty ajanjaksosuodatin. Sallitut arvot: today, yesterday, last_24h, last_3days, last_7days.
number	Valinnainen. Suodata vastaanottajan puhelinnumeron mukaan.
sIdentifiant	Valinnainen. Suodata mobiililaitteen tunnuksen mukaan.
message	Valinnainen. Suodata tekstiviestien sisällön mukaan.
search	Valinnainen. Globaali haku käytössä sIdentifiant, number, message, mobile_date_formatted, ja synchro_time.
sort_by	Valinnainen. Lajittelukenttä. Sallitut arvot: sIdentifiant, number, message, mobile_date_ms, mobile_date_formatted, synchro_time.
sort_order	Valinnainen. Lajittelujärjestys: ASC tai DESC.
limit	Valinnainen. Palautettujen rivien enimmäismäärä. Suurin sallittu arvo: 200.

Palautetut kentät:

Ala	Kuvaus
sIdentifiant	Lähetettyyn tekstiviestiin linkitetty matkapuhelintunnus.
number	Vastaanottajan puhelinnumero.
message	Tekstiviestien sisältö.
mobile_date_ms	Alkuperäisen tekstiviestin aikaleima millisekunteina.
mobile_date_formatted	Mobiililaitteelta vastaanotettu muotoiltu päivämäärä.
synchro_time	Päivämäärä ja kellonaika, jolloin tekstiviesti synkronoitiin SMSMobileAPIin.

Esimerkki:

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

Esimerkki suodattimien kanssa:

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

Esimerkki ennalta määritellyllä ajanjaksolla:

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

SMS vastaanotettu

Tätä API-päätepistettä käytetään älypuhelimeen vastaanotettujen tekstiviestien noutamiseen.

Päätepiste:

SAADA https://api.smsmobileapi.com/getsms/

Parametri:

Parametri	Kuvaus
apikey	Pakollinen API-avain, joka sinulla on tai saat.
sIdentifiantPhone	Eristä vastaanotettuun tekstiviestiin linkitetty puhelin.
after_timestamp_unix	Listaa vastaanotetut tekstiviestit UNIX-aikaleiman jälkeen.
onlyunread	"kyllä" = listaa vain luetuiksi merkitsemättömät tekstiviestit (API-tila).

Esimerkki:

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

Merkitse vastaanotetut tekstiviestit luetuiksi

Tätä API-päätepistettä käytetään merkitsemään yksi vastaanotettu tekstiviesti luetuksi Vain API-tila.
Tämä ei muuta älypuhelimen lukutilaa.

Päätepiste:

SAADA https://api.smsmobileapi.com/getsms/set-read/

Parametri:

Parametri	Kuvaus
apikey	Pakollinen API-avain, joka sinulla on tai saat.
guid_message	Pakollinen Luetuksi merkittävän viestin GUID.

Esimerkki:

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

Päivitä tekstiviestialias

Tätä API-päätepistettä käytetään vastaanotetun tekstiviestin aliaksen päivittämiseen sen GUID:n avulla.

Huomautus: The alias parametri voi olla tyhjä. Siinä tapauksessa alias tyhjennetään.

Päätepiste:

SAADA LÄHETTÄÄ https://api.smsmobileapi.com/getsms/update/

Parametrit:

Parametri	Kuvaus
apikey	Pakollinen API-avaimesi.
guid	Pakollinen Vastaanotetun päivitettävän tekstiviestin GUID.
alias	Pakollinen Tälle tekstiviestille annettava alias. Tämä arvo voi olla tyhjä, jos haluat tyhjentää nykyisen aliaksen.

Esimerkki:

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

Esimerkki aliaksen tyhjentämisestä:

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

Poista tekstiviesti

Tätä API-päätepistettä käytetään tekstiviestien poistamiseen SMS Mobile API:n palvelinlokista.

Päätepiste:

SAADA https://api.smsmobileapi.com/deletesms/

Parametri:

Parametri	Kuvaus
apikey	Pakollinen Sinulla oleva API-avain.
guid_message	Poistettavan viestin yksilöllinen tunnus.
date_start	Yksin käytettynä poistaa kaikki viestit määritetyltä päivältä.
date_start and date_end	Yhdistetty viestien poistamiseen tietyn ajan kuluessa.

Esimerkki:

HANKI https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY

Huomautus: Poistetut tekstiviestit tallennetaan vain palvelinlokeihin. Laitteessa olevia tekstiviestejä ei poisteta.

Listaa tekstiviestikeskustelut

Tätä API-päätepistettä käytetään tiliisi linkitettyjen tekstiviestikeskustelujen listaamiseen.

Jokainen keskustelu on ryhmitelty puhelinnumeron mukaan ja sisältää siihen liittyvät saapuvat ja lähtevät tekstiviestit.

Huomautus: Keskustelun lähtökohta määritellään seuraavasti: origineConversation parametri:

received: keskustelut havaitaan ensin vastaanotetuista tekstiviesteistä logsmsreceive
sent: keskustelut havaitaan ensin lähetetyistä tekstiviesteistä logsmssent

Huomautus: Jos numero ei anneta, API palauttaa vain uusimmat keskustelut. Oletusarvoisesti viimeisin 20 keskustelut palautetaan.

Huomautus: Lähtevien tekstiviestien osalta, jos timearea_of_message on saatavilla (esim. UTC+02), näytetty päivämäärä muunnetaan automaattisesti tämän arvon avulla. Tätä muunnettua päivämäärää käytetään myös lajitteluun.

Huomautus: Jos resume=1, vain kunkin keskustelun uusimmat viestit palautetaan. Käytä resume_line_how määrittääksesi, kuinka monta uusinta viestiä sisällytetään.

Päätepiste:

SAADA LÄHETTÄÄ https://api.smsmobileapi.com/conversation/sms/list/

Parametrit:

Parametri	Kuvaus
apikey	Pakollinen API-avaimesi.
origineConversation	Pakollinen Määrittää keskusteluluettelon aloituskohdan. Sallitut arvot: received tai sent.
numero	Valinnainen Suodata tulos vain yhden tietyn puhelinnumeron mukaan.
date_from	Valinnainen Aloituspäivämääräsuodatin keskusteluille ja viesteille. Hyväksytty muoto: YYYY-MM-DD tai täydellinen päivämäärä- ja aika-arvo.
date_to	Valinnainen Keskustelujen ja viestien lopetuspäivämääräsuodatin. Hyväksytty muoto: YYYY-MM-DD tai täydellinen päivämäärä- ja aika-arvo.
sort	Valinnainen Keskustelujen lajittelujärjestys. Sallitut arvot: DESC tai ASCOletusarvo: DESC.
limit	Valinnainen Palautettavien keskustelujen enimmäismäärä, kun numero ei ole annettu. Oletusarvo: 20.
resume	Valinnainen Jos asetettu arvoon 1, vain kunkin keskustelun uusimmat viestit palautetaan.
resume_line_how	Valinnainen Keskustelua kohden palautettavien viimeisimpien viestien määrä, kun resume=1Oletusarvo: 1.

Käyttäytymisen tiedot:

Saapuvat tekstiviestit luetaan osoitteesta logsmsreceive.
Lähtevät tekstiviestit luetaan osoitteesta logsmssent.
Saapuvat viestit palaavat aina takaisin direction = "incoming".
Lähtevät viestit palaavat aina takaisin direction = "outgoing".
Yhteystiedon alias on otettu logsmsreceive.alias kun saatavilla.
Saapuvien tekstiviestien mobiili-SID tulee osoitteesta sIdentifiant_pour_read.
Lähtevien tekstiviestien mobiili-SID tulee osoitteesta send_from_mobile_sIdentifiant.
Lähtevien tekstiviestien osalta näytetty päivämäärä säädetään timearea_of_message jos tämä kenttä ei ole tyhjä.

Esimerkki 1 - Listaa viimeisimmät keskustelut vastaanotetuista tekstiviesteistä:

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

Esimerkki 2 - Listaa lähetettyjen tekstiviestien viimeisimmät keskustelut:

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

Esimerkki 3 – Suodata yksi tietty puhelinnumero:

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

Esimerkki 4 - Suodata päivämäärävälin mukaan:

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

Esimerkki 5 - Jatka-tila, jossa on kolme viimeisintä viestiä keskustelua kohden:

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

Esimerkki onnistuneesta vastauksesta:

{ "success": true, "origineConversation": "received", "resume": 0, "resume_line_how": null, "conversations": [ { "phone_number": "+10470000001", "contact_alias": "Matti Meikäläinen", "messages": [ { "direction": "incoming", "message_id": "msg_1001", "date": "2026-03-13 08:45:12", "timestamp_utc": "2026-03-13T08:45:12Z", "message": "Hei, haluaisin lisätietoja.", "status": "received", "mobile_sid": "device_sid_1" }, { "direction": "outgoing", "message_id": "msg_1002", "date": "2026-03-13" 10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "Totta kai, mitä haluaisit tietää?", "status": "lähetetty", "mobile_sid": "device_sid_2" } ] } ] }

Vastauskentät:

Ala	Kuvaus
success	Ilmaisee, onnistuiko pyyntö.
origineConversation	Keskusteluluettelon luomiseen käytetty aloitustila.
resume	Ilmaisee, onko jatkamistila käytössä.
resume_line_how	Keskustelua kohden palautettujen viimeisimpien rivien määrä, kun jatkamistila on käytössä.
conversations	Keskustelujen kirjo.
phone_number	Puhelinnumero, jota käytetään keskustelun tunnistamiseen.
contact_alias	Puhelinnumeroon linkitetty alias, jos saatavilla.
messages	Keskustelun sisällä olevien tekstiviestien joukko.
direction	incoming vastaanotettuja tekstiviestejä varten, outgoing lähetettyjä tekstiviestejä varten.
message_id	Viestin yksilöllinen tunniste.
date	Viestin näyttöpäivämäärä. Lähtevien tekstiviestien osalta tätä arvoa voidaan säätää käyttämällä timearea_of_message.
timestamp_utc	Viestin UTC-aikaleima.
message	Viestin sisältö.
status	received saapuvia tekstiviestejä varten, sent lähteviä tekstiviestejä varten.
mobile_sid	Viestin vastaanottaneen tai lähettäneen mobiililaitteen SID.

Virheesimerkki:

{ "success": false, "error": "Puuttuva pakollinen parametri: apikey" }

Huomautuksia:

Jos numero jos numero annetaan, API palauttaa vain tähän puhelinnumeroon linkitetyn keskustelun.
Jos numero ei ole annettu, API palauttaa uusimmat keskustelut valitun lähtötilan mukaan.
Saapuvat ja lähtevät viestit yhdistetään yhdeksi aikajanaksi kullekin puhelinnumerolle.
Lähtevien viestien lajittelu ottaa huomioon mukautetun paikallisen päivämäärän, kun timearea_of_message on saatavilla.
Jatka-tila on hyödyllinen koontinäytöille, widgeteille, esikatseluille ja keskusteluyhteenvedoille.

Yhdyskäytävä – Listaa yhdistetyt matkapuhelimet

Listaa laitteeseesi yhdistetyt matkapuhelimet SMS-yhdyskäytävä.

Päätepiste:

SAADA LÄHETTÄÄ https://api.smsmobileapi.com/gateway/mobile/list/

Parametrit:

Parametri	Kuvaus
apikey	Pakollinen API-avaimesi.
sid	Suodata tarkan SID:n (sIdentifiant_pour_check) mukaan.
search	Hae kentistä (puoli, päivämäärä, akku, versio, nimi...).

Esimerkki:

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

Huomautus: Vastaanotettujen tekstiviestien tilastot ovat saatavilla mobiilisovelluksen versiosta 3.0.33.3+ alkaen.

Yhdyskäytävä – Päivitä mobiilitarra

Päivitä yhdistetyn mobiililaitteen otsikko (nom_reference).

Päätepiste:

SAADA LÄHETTÄÄ https://api.smsmobileapi.com/gateway/mobile/update/

Parametrit:

Parametri	Kuvaus
apikey	Pakollinen API-avaimesi.
sid	Pakollinen Laitteen SID (sIdentifiant_pour_check).
label	Uusi etiketti
phone_number	Uusi puhelinnumero

Esimerkki:

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

Tärkeää: otsikko on pakollinen, mutta voi olla tyhjä (etiketti=).

Yhdyskäytävä – Yhdistetty mobiililaite

Poista yhdistetty matkapuhelin yhdyskäytävästäsi (poistaa kaikki tämän SID:n historiarivit).

Päätepiste:

SAADA LÄHETTÄÄ https://api.smsmobileapi.com/gateway/mobile/delete/

Parametrit:

Parametri	Kuvaus
apikey	Pakollinen API-avaimesi.
sid	Pakollinen Laitteen SID (sIdentifiant_pour_check).

Esimerkki:

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

Webhook – SMS vastaanotettu

Tämä webhook-järjestelmä lähettää POST-pyynnön määritettyyn URL-osoitteeseen aina, kun tekstiviesti vastaanotetaan. Järjestelmä varmistaa reaaliaikaiset päivitykset toimittamalla tekstiviestin tiedot määritettyyn webhook-URL-osoitteeseen.

Webhookin määrittäminen hallintapaneelissa

Määritä webhookin URL-osoite hallintapaneelissa noudattamalla näitä ohjeita:

Kirjaudu tilillesi osoitteessa SMS Mobile API Dashboard.
Navigoi kohtaan Webhook-asetukset osio.
Anna webhookin URL-osoite (esim. https://example.com/webhook-endpoint).
Napsauta Tallenna Webhook -painiketta.
Kun järjestelmä on tallennettu, se alkaa lähettää tekstiviestitietoja määritettyyn URL-osoitteeseen.

Webhook-hyötykuorma

Kun tekstiviesti vastaanotetaan, järjestelmä lähettää seuraavan JSON-hyötykuorman webhook-URL-osoitteeseen:

{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "Hei, tämä on testi.", "number": "+123456789", "guid": "abcde12345" }

Hyötykuormakentät:

päivämäärä: Päivämäärä, jolloin tekstiviesti lisättiin (VVVV-KK-PP).
tunnin: Tunti, jolloin tekstiviesti lisättiin (HH:mm:ss).
time_received: Aika, jolloin tekstiviesti vastaanotettiin.
viesti: Tekstiviestin sisältö.
määrä: Lähettäjän puhelinnumero.
opas: SMS-viestin yksilöllinen tunniste.

Esimerkki Webhook-päätepiste

Palvelimesi pitäisi olla valmis käsittelemään saapuvia POST-pyyntöjä. Alla on esimerkki PHP-skriptistä webhook-hyötykuorman käsittelemiseksi:

Webhookin testaus

Voit testata webhookin määrityksiä käyttämällä työkaluja, kuten:

Vianetsintä

Varmista, että webhookin URL-osoite on oikea ja julkisesti saatavilla.
Varmista, että palvelimesi palauttaa HTTP 200 -tilakoodin onnistuneille pyynnöille.
Tarkista palvelimesi lokeista hyötykuorman käsittelyssä tapahtuneet virheet.

Rikastettu tekstiviesti

Tulossa pian

Todennus

SMSMobile API tukee kahta todennusmenetelmää: käyttämällä yksinkertaista API-avainta tai OAuth2-protokollaa, jossa on asiakastunnus ja asiakassalaisuus.

1. API-avaimen todennus

Tämä menetelmä vaatii API-avaimen, joka voidaan sisällyttää parametrina joko GET- tai POST-pyyntöön.

2. OAuth2-todennus

OAuth2 tarjoaa turvallisemman todennusmenetelmän.
Käytä asiakastunnusta ja asiakkaan salaisuutta saadaksesi käyttöoikeustunnuksen ja lisää se sitten Valtuutus otsikko.

Asiakastunnus ja client_secret ovat saatavilla hallintapaneelissasi.
Lataa mobiilisovellus nyt tai käytä kojelautaasi.

Käyttöoikeustunnuksen hankkiminen


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"

Käyttöoikeustunnuksen käyttäminen:


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

-H "Valtuutus: Haltija YOUR_ACCESS_TOKEN" \

-H "Sisältötyyppi: Application/x-www-form-urlencoded" \

-d "vastaanottajat=+1234567890" \

-d "viesti=Hei"

Mitä menetelmää sinun tulisi käyttää?

- Käytä API-avaimen todennus nopeaa ja suoraviivaista integrointia varten.

- Käytä OAuth2-todennus parannetun turvallisuuden ja skaalautuvuuden takaamiseksi.

Lähetä SMS

WSDL URL

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

Parametrit:

- recipients: Vastaanottajan matkapuhelinnumero.
- message: Viesti lähetettäväksi.
- apikey: API-avain, joka sinulla on tai saat.

Esimerkki


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);

Lähetä SMS & WhatsApp

Perus cURL-komento


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"

Lähetä SMS & WhatsApp

Käytä virallista Python-moduuliamme: 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 (säveltäjä)

säveltäjä vaatii smsmobileapi/sdk

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

Lähetä SMS & 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);

Lähetä SMS & 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));

Lähetä SMS & 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

Napsauta tätä testataksesi API-avainta ja palvelua yksinkertaisella lomakkeella

Riippuen matkapuhelimeen asennetusta Android-versiosta, käyttöjärjestelmä voi haitata tekstiviestien automaattisen lähettämisen ja vastaanottamisen asianmukaista toimintaa, kun SmsMobileApi-sovellus ei ole etualalla.
Tämä ongelma johtuu prosessista, joka yrittää suorittaa taustalla, kun sovellusta ei käynnistetä aktiivisesti. Androidin akun optimointitoimenpiteiden vuoksi, jotka vaihtelevat eri versioiden välillä, tämä taustaprosessi ei välttämättä käynnisty oikein. Androidin akun optimointi on suunniteltu rajoittamaan sovellusten taustatoimintaa akun käyttöiän säästämiseksi, mikä voi vahingossa vaikuttaa sovelluksiin, jotka vaativat taustaprosesseja toimiakseen kunnolla.

Tämän ongelman ratkaisemiseksi käyttäjät voivat määrittää Android-asetukset manuaalisesti siten, että SmsMobileApi voi käyttää resursseja ilman rajoituksia.
Tämä sisältää tietyn sovelluksen akun optimointiasetusten säätämisen, lähinnä Androidille ohjeistamisen, että SmsMobileApi saa toimia taustalla ja käyttää resursseja tarpeen mukaan. Näin tehden sovelluksen pitäisi pystyä automaattisesti lähettämään ja vastaanottamaan tekstiviestejä, vaikka se ei olisikaan aktiivinen sovellus etualalla. Tämä säätö varmistaa, että tarvittava taustaprosessi voi toimia keskeytyksettä ja kiertää akun optimointiominaisuudet, jotka muuten voisivat estää sen asianmukaisen suorittamisen.

FAQ Kehittäjälle

Kuinka luoda API-avain?

Harmonikkaesimerkkikuvaus Voit luoda API-avaimen lataamalla sovelluksemme matkapuhelimeesi ja luomalla tilin maksutta. API-avain luodaan automaattisesti ja linkitetään matkapuhelimeesi. Saat myös sähköpostin, jossa on kaikki tarvittavat tiedot. Tämä prosessi varmistaa, että voit nopeasti ja helposti aloittaa palveluidemme käytön minimaalisella asennuksella.

Mistä löydän aina API-avaimeni?

Siirry mobiilisovelluksessasi ASETUKSET- tai OHJE-valikkoon, jossa API-avaimesi on aina näkyvissä. Tämä varmistaa, että pääset helposti käsiksi API-avaimellesi aina, kun tarvitset sitä palveluidemme integroimiseen tai käyttämiseen.

Voiko API-avaimen luominen olla nimetöntä?

Kyllä, emme vaadi henkilöllisyystodistusta API-avaimen luomiseen. API-liittymämme ja matkapuhelimesi välinen viestintä on siksi 100% nimetöntä. Tämän lähestymistavan avulla käyttäjät voivat säilyttää yksityisyytensä palveluitamme käyttäessään.

Aloita SMSmobileAPI jo tänään!

Koe tekstiviestipalveluidesi hallinnan vapaus ja joustavuus liikkeellä ollessasi. Lataa mobiilisovelluksemme nyt ja ota ensimmäinen askel kohti saumatonta tekstiviestien integrointia.

Lataa sovellus

API & Developer Docs

Työkalu- ja muutosloki

Lähetä SMS

Päätepiste:

Parametrit:

Esimerkki:

Lähetä uudelleen lähettämätön tekstiviesti

Päätepiste:

Parametri:

Esimerkki:

API:lta lähetetty tekstiviestiloki

Päätepiste:

Parametri:

Esimerkki:

Listaa matkapuhelimesta lähetetyt tekstiviestit

Päätepiste:

Parametrit:

Palautetut kentät:

Esimerkki:

Esimerkki suodattimien kanssa:

Esimerkki ennalta määritellyllä ajanjaksolla:

SMS vastaanotettu

Päätepiste:

Parametri:

Esimerkki:

Merkitse vastaanotetut tekstiviestit luetuiksi

Päätepiste:

Parametri:

Esimerkki:

Päivitä tekstiviestialias

Päätepiste:

Parametrit:

Esimerkki:

Esimerkki aliaksen tyhjentämisestä:

Poista tekstiviesti

Päätepiste:

Parametri:

Esimerkki:

Listaa tekstiviestikeskustelut

Päätepiste:

Parametrit:

Käyttäytymisen tiedot:

Esimerkki 1 - Listaa viimeisimmät keskustelut vastaanotetuista tekstiviesteistä:

Esimerkki 2 - Listaa lähetettyjen tekstiviestien viimeisimmät keskustelut:

Esimerkki 3 – Suodata yksi tietty puhelinnumero:

Esimerkki 4 - Suodata päivämäärävälin mukaan:

Esimerkki 5 - Jatka-tila, jossa on kolme viimeisintä viestiä keskustelua kohden:

Esimerkki onnistuneesta vastauksesta:

Vastauskentät:

Virheesimerkki:

Huomautuksia:

Yhdyskäytävä – Listaa yhdistetyt matkapuhelimet

Päätepiste:

Parametrit:

Esimerkki:

Yhdyskäytävä – Päivitä mobiilitarra

Päätepiste:

Parametrit:

Esimerkki:

Yhdyskäytävä – Yhdistetty mobiililaite

Päätepiste:

Parametrit:

Esimerkki:

Webhook – SMS vastaanotettu

Webhookin määrittäminen hallintapaneelissa

Webhook-hyötykuorma

Hyötykuormakentät:

Esimerkki Webhook-päätepiste

Webhookin testaus

Vianetsintä

Rikastettu tekstiviesti

Todennus

1. API-avaimen todennus

2. OAuth2-todennus

Käyttöoikeustunnuksen hankkiminen

Käyttöoikeustunnuksen käyttäminen:

Mitä menetelmää sinun tulisi käyttää?

Lähetä SMS

WSDL URL

Parametrit: