Start her

Din første anmodning i fire trin

Opret en konto og kopiér API-tasten fra instrumentbrættet.

Installer den mobile app og bekræfte, at enheden er online.

Send en test SMS med / sendsms / endpoint.

Gem den returnerede meddelelse ID til at korrelere logs og leveringsstatus.

Den sikre SMSMobileAPI mobil app, der forbinder en telefon til web dashboard og REST API til SMS og opkald operationer — Krypteret mobil- to- platform- forbindelse

Officiel mobilapplikation

Den sikre bro mellem telefonen, instrumentbrættet og API.

SMS og opkald operationer passere gennem den officielle SMSMobileAPI app installeret på din tilsluttede telefon. App sikkert parrer enheden med din konto, synkroniserer godkendte begivenheder og forbinder mobilnetværket til instrumentbrættet og REST API.

1Mobil appParerer telefonen og dens SIM 2Krypteret linkAutentificerer og beskytter data i transit 3Dashboard & APIStyrer arbejdsgange og aktivitet

Signerede udgivelser distribueret gennem de officielle Google Play og Apple App Store lister
Google og Apple platform gennemgang, signaturer og distribution kontrol
Sikker parring af enheden, HTTPS transport og autentificeret API adgang
Kun de tilladelser, der kræves for de mobile funktioner, du aktiverer

Få den officielle SMSMobileAPI app på Google Play

Download den officielle SMSMobileAPI app på Apple App Store

Kapacitet afhænger af tilladelser og baggrundsadgang tilladt af Android eller iOS.

Autentificering

Behold legitimation på din server

Hver anmodning accepterer en API-nøgle gennem den apikey parameter. OAuth2 klient legitimation er også tilgængelige for server- to- server integrationtioner. Aldrig afsløre en produktionstast i browser kode, offentlige datalagre eller supportmeddelelser.

PUNKT ·

Send en SMS

ENDPOINThttps://api.smsmobileapi.com/sendsms/

Kører en besked på en tilsluttet telefon. POST anbefales, når meddelelsen er lang eller indeholder særlige tegn.

Hvornår skal du bruge det

Brug dette til transaktionsmeddelelser, påmindelser, advarsler og application- genereret SMS.

Parametre

Navn	Type	Krav	Beskrivelse
`apikey`	snor	Påkrævet	Din konto API nøgle.
`recipients`	telefon	Påkrævet	Bestemmelsesnummer i internationalt format.
`message`	snor	Påkrævet	Besked krop. URL-kode det, når du bruger GET.
`port`	1 \| 2	Valgfri	SIM-port på kompatible Android-enheder; lad tom til automatisk valg.
`sIdentifiant`	snor	Valgfri	Specifikke tilsluttet telefon SID; lad tom for den første tilgængelige enhed.
`shorturl`	0 \| 1	Valgfri	Sæt til 1 for at forkorte URL 'er fundet i meddelelsen.
`sendsms`	0 \| 1	Valgfri	SMS kanalflag. Standard til 1, hvis udeladt.
`sendwa`	0 \| 1	Valgfri	Anmod også WhatsApp levering, når kontoen understøtter det.
`encrypt_message`	ja	Valgfri	Kryptér beskeden for beskyttet læsning af sideværts.
`schedule_timestamp`	Unix sekunder	Valgfri	UTC-tid, hvorfra meddelelsen kan sendes.

Eksempel på anmodning

krølle

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."

Eksempel på svar

JSON

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Godt at vide

Et vellykket API svar betyder, at meddelelsen blev accepteret af platformen; holde den returnerede id for senere sporing.
Carrier levering og mobil behandling kan ske efter HTTP svar.

PUNKT ·

Gensend en ikke-sendt SMS

ENDPOINThttps://api.smsmobileapi.com/resend/

Genstarter en meddelelse, der i øjeblikket er i en fejltilstand.

Hvornår skal du bruge det

Brug dette efter at have kontrolleret den sendte log og bekræftet at en mislykket meddelelse er berettiget til et andet forsøg.

Parametre

Navn	Type	Krav	Beskrivelse
`apikey`	snor	Påkrævet	Din konto API nøgle.
`guid`	snor	Påkrævet	Meddelelsens GUID returneres af sende- eller logendepunktet.

Eksempel på anmodning

krølle

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

Eksempel på svar

JSON

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Godt at vide

Kun meddelelser med fejlstatus kan være negative.

FÅ

Liste SMS sendt fra API

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

Returnerer meddelelser indsendt via SMS API med kø, mobil og fejlinformation.

Hvornår skal du bruge det

Brug det til levering overvågning, støtte diagnostik og forsoning.

Parametre

Navn	Type	Krav	Beskrivelse
`apikey`	snor	Påkrævet	Din konto API nøgle.
`guid_message`	snor	Valgfri	Returnerer en besked ved sin unikke GUID.
`before`	tidsstempel eller reference	Valgfri	Returnér beskeder før den medfølgende markør eller tidsstempel.
`error_api`	0 \| 1	Valgfri	Sæt til 1 for at returnere kun API behandlingsfejl.
`error_mobile`	0 \| 1	Valgfri	Sæt til 1 for at returnere mobile afsenderfejl.
`keyword`	snor	Valgfri	Søg i modtagernummeret eller meddelelsesteksten.

Eksempel på anmodning

krølle

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

Eksempel på svar

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

FÅ

Liste SMS synkroniseret fra en telefon

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

Lister SMS fysisk sendt af en mobil og synkroniseret med platformen.

Hvornår skal du bruge det

Brug den, når beskeder kan stamme fra telefonen samt gennem API.

Parametre

Navn	Type	Krav	Beskrivelse
`apikey`	snor	Påkrævet	Din konto API nøgle.
`date`	ÅÅÅÅ-MM-DD	Valgfri	Filtrér en præcis dato.
`date_from`	ÅÅÅÅ-MM-DD	Valgfri	Start på et datoområde.
`date_to`	ÅÅÅÅ-MM-DD	Valgfri	Slut på et datoområde.
`period`	enum	Valgfri	i dag, i går, sidste _ 24h, sidste _ 3dage eller sidste _ 7dage.
`number`	telefon	Valgfri	Filtrér efter modtager.
`sIdentifiant`	snor	Valgfri	Filtrér ved tilsluttet mobil SID.
`message`	snor	Valgfri	Filtrér efter brevindhold.
`search`	snor	Valgfri	Global søgning på tværs af mobil, nummer, besked og tidsstempler.
`sort_by`	enum	Valgfri	sIdentifiant, nummer, besked, mobil _ date _ ms, mobil _ date _ formatted eller synchro _ time.
`sort_order`	ASC-nummer 124; DESC	Valgfri	Sorter retning.
`limit`	heltal	Valgfri	Højst 200 plader.

Eksempel på anmodning

krølle

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

Eksempel på svar

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Godt at vide

Kræver Android app 4.1.20 eller nyere og skal være aktiveret i app 'en.
Dette endpoint giver maksimalt syv dages synkroniseret historie.

FÅ

Liste modtaget SMS

ENDPOINThttps://api.smsmobileapi.com/getsms/

Returnerer indgående SMS synkroniseret fra tilsluttede telefoner.

Hvornår skal du bruge det

Brug det til at opbygge en indbakke, meningsmåling for svar eller gendanne beskeder efter en webhook afbrydelse.

Parametre

Navn	Type	Krav	Beskrivelse
`apikey`	snor	Påkrævet	Din konto API nøgle.
`sIdentifiantPhone`	snor	Valgfri	Filtrér ved telefonen, der modtog SMS 'en.
`after_timestamp_unix`	Unix sekunder	Valgfri	Returnér breve modtaget efter dette tidsstempel.
`onlyunread`	ja	Valgfri	Returnerer kun breve, der ikke er markeret som læst i API tilstand.

Eksempel på anmodning

krølle

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

Eksempel på svar

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

PUNKT ·

Markér en modtaget SMS som læst

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

Marks en modtaget besked som læst i SMSMobileAPI API tilstand.

Hvornår skal du bruge det

Brug dette efter at din ansøgning har behandlet en indgående besked.

Parametre

Navn	Type	Krav	Beskrivelse
`apikey`	snor	Påkrævet	Din konto API nøgle.
`guid_message`	snor	Påkrævet	GUID for den modtagne SMS.

Eksempel på anmodning

krølle

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Godt at vide

Dette ændrer ikke læsetilstanden i telefonens meddelelsesprogram.

PUNKT ·

Opdatér et modtaget SMS-alias

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

Tilføjelse, ændring eller clearing af alias, der er forbundet med en modtaget SMS.

Hvornår skal du bruge det

Brug aliasser til at vedhæfte et kontaktnavn eller en applikationsetiket til en meddelelse.

Parametre

Navn	Type	Krav	Beskrivelse
`apikey`	snor	Påkrævet	Din konto API nøgle.
`guid`	snor	Påkrævet	GUID for den modtagne SMS.
`alias`	snor	Påkrævet	Nyt alias. Send en tom værdi for at rydde den.

Eksempel på anmodning

krølle

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

PUNKT ·

Slet SMS serverlogfiler

ENDPOINThttps://api.smsmobileapi.com/deletesms/

Sletter SMS-optegnelser fra SMSMobileAPI- serverloggen.

Hvornår skal du bruge det

Brug det til at holde arbejdsgange eller fjerne en bestemt logget besked.

Parametre

Navn	Type	Krav	Beskrivelse
`apikey`	snor	Påkrævet	Din konto API nøgle.
`guid_message`	snor	Valgfri	Slet en besked ved GUID.
`date_start`	ÅÅÅÅ-MM-DD	Valgfri	Slet optegnelser fra denne dato.
`date_end`	ÅÅÅÅ-MM-DD	Valgfri	Med dato _ start, begrænser sletning område.

Eksempel på anmodning

krølle

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

Eksempel på svar

JSON

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Godt at vide

Dette sletter kun server- logindgange. Det sletter ikke beskeder gemt på den mobile enhed.
Behandl denne operation som destruktiv og verificer filtre, før du ringer til den.

FÅ

Liste over SMS-samtaler

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

Grupper indkommende og udgående meddelelser i samtaler via telefonnummer.

Hvornår skal du bruge det

Brug det til chatvisninger, nylige samtalekontroller og understøtter tidslinjer.

Parametre

Navn	Type	Krav	Beskrivelse
`apikey`	snor	Påkrævet	Din konto API nøgle.
`origineConversation`	modtaget 124; sendt	Påkrævet	Dataset bruges til at identificere de indledende samtaler.
`numero`	telefon	Valgfri	Aflever en telefonsamtale.
`date_from`	dato eller datetime	Valgfri	Start af meddelelsesområdet.
`date_to`	dato eller datetime	Valgfri	Slut på meddelelsesområdet.
`sort`	ASC-nummer 124; DESC	Valgfri	Samtalelsesordre; standard DESC.
`limit`	heltal	Valgfri	Samtalegrænse, når numero udelades; standard 20.
`resume`	0 \| 1	Valgfri	Sæt til 1 for kun at returnere de seneste beskeder per samtale.
`resume_line_how`	heltal	Valgfri	Antal meddelelser pr. samtale, når CV = 1.

Eksempel på anmodning

krølle

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

Eksempel på svar

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

FÅ

Liste over tilsluttede mobiltelefoner

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

Lister telefoner tilsluttet SMS gateway-kontoen.

Hvornår skal du bruge det

Brug den til at vælge en afsender, vise enhedsstatus eller revidere en gateway flåde.

Parametre

Navn	Type	Krav	Beskrivelse
`apikey`	snor	Påkrævet	Din konto API nøgle.
`sid`	snor	Valgfri	Returnerer en præcis mobil SID.
`search`	snor	Valgfri	Søg SID, dato, batteri, version, etiket og relaterede felter.

Eksempel på anmodning

krølle

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

PUNKT ·

Opdater en tilsluttet mobil

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

Opdaterer det humanistiske mærke eller telefonnummer på en tilsluttet enhed.

Hvornår skal du bruge det

Brug det til at holde enhedsetiketter meningsfulde i flertelefonanlæg.

Parametre

Navn	Type	Krav	Beskrivelse
`apikey`	snor	Påkrævet	Din konto API nøgle.
`sid`	snor	Påkrævet	Enheden SID.
`label`	snor	Påkrævet	Ny etiket; den kan med vilje være tom.
`phone_number`	telefon	Valgfri	Nye telefonnumre metadata.

Eksempel på anmodning

krølle

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

PUNKT ·

Slet en tilsluttet mobil

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

Fjerner en tilsluttet mobil og dens portohistorik rækker.

Hvornår skal du bruge det

Brug kun når en telefon skal fjernes permanent fra kontoen.

Parametre

Navn	Type	Krav	Beskrivelse
`apikey`	snor	Påkrævet	Din konto API nøgle.
`sid`	snor	Påkrævet	SID på den anordning, der skal fjernes.

Eksempel på anmodning

krølle

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

Vil du køre denne anmodning?Tilslut din API nøgle øverst på siden for at låse den interaktive tester op.

Forbind nøgle ↑

Godt at vide

Denne operation fjerner udstyrets historie i forbindelse med SID. Bekræft anordningen, før du ringer.

UDEN BOUND PORT

Modtag SMS efter webhook

BESTEMMELSEYour HTTPS endpoint

SMSMobileAPI sender en JSON anmodning til din konfigurerede URL, når en SMS modtages.

Hvornår skal du bruge det

Brug webkroge til realtidsbehandling i stedet for hyppig valsning.

Modtagereksempel

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

Eksempel på svar

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

Indgående endepunkt

Dette endpoint modtager hændelser på din egen HTTPS URL. Brug ovenstående eksempel på modtager, og send derefter en SMS til din tilsluttede telefon for at teste den.

Godt at vide

Indstil den offentlige HTTPS URL i Dashboard → Webhook Indstillinger.
Returnér HTTP 200 hurtigt og bearbejd begivenheden asynkron.
Afduk gentagelser med guid.

Fejlfinding

Fejl og sikre forsøg på at vende tilbage

Læs HTTP status og JSON fejlfeltet før genforsøg. Fortryd ikke validerings- eller autentificeringsfejl uden først at korrigere anmodningen.

HTTP	Kode	Hvad skal man gøre?
400	`missing_parameter`	En krævet parameter er tom eller fraværende. Kontroller parametertabellen for endepunktet.
403	`invalid_apikey`	API-tasten er ukendt, udløbet eller ikke godkendt til den ønskede funktion.
429	`too_many_requests`	Anmodningerne kommer for hurtigt. Vent, så prøv igen med eksponentiel backoff.
500	`server_error`	Tjenesten kunne ikke afslutte anmodningen. Behold svar- og kontaktsupport, hvis den fortsætter.

Foretag at genfinde regelPrøv kun forbigående 429 - og 5xx - respons igen. Start efter 1 sekund, og træk så tilbage til 2, 4 og 8 sekunder.

Brug for hjælp?

Medbring forespørgslen kontekst - ikke dine hemmeligheder.

Del endepunkt, tidsstempel, HTTP status og renset respons. Aldrig inkludere API nøgler, tokens eller privat besked indhold.

Kontakt API support →

SMS API dokumentation

Din første anmodning i fire trin

Den sikre bro mellem telefonen, instrumentbrættet og API.

Behold legitimation på din server

Parametre

Eksempel på anmodning

Eksempel på svar

Parametre

Eksempel på anmodning

Eksempel på svar

Parametre

Eksempel på anmodning

Eksempel på svar

Parametre

Eksempel på anmodning

Eksempel på svar

Parametre

Eksempel på anmodning

Eksempel på svar

Parametre

Eksempel på anmodning

Parametre

Eksempel på anmodning

Parametre

Eksempel på anmodning

Eksempel på svar

Parametre

Eksempel på anmodning

Eksempel på svar

Parametre

Eksempel på anmodning

Parametre

Eksempel på anmodning

Parametre

Eksempel på anmodning

Modtagereksempel

Eksempel på svar

Fejl og sikre forsøg på at vende tilbage

Medbring forespørgslen kontekst - ikke dine hemmeligheder.