Dev DOC - SMSMobileAPI

SMS-dokumentation

SMSmobileAPI utvecklardokumentation

På SMSmobileAPI strävar vi efter att göra vårt API så kompatibelt som möjligt med vilken arkitektur eller plattform som helst.
Whether you’re using REST, SOAP, cURL, or various programming languages like Python, JavaScript, PHP, and more, our API is designed to integrate seamlessly into your projects.

Vi har även färdiga plugins för e-handelslösningar och mjukvara. Klicka här för att upptäcka dem.

.

API REST

cURL

Composer

JavaScript

Pytonorm

Node.js

Rubin

WSDL

Skicka SMS

Denna slutpunkt låter dig skicka ett SMS från din mobiltelefon.

Slutpunkt:

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

Parametrar:

- apikey: Din unika API-nyckel.

- recipients: Mottagarens telefonnummer.

- message: Meddelandet som ska skickas (Meddelandets längd är inte begränsad till 160 tecken; du kan skicka längre meddelanden)

- sendwa: 1 = meddelandet måste skickas via WhatsApp.

- sendsms: 1 = meddelandet måste skickas via ett traditionellt SMS. (Om skicka sms är tom: skickas som standard, inställd på 0 för att blockera SMS)

- schedule_timestamp = Representerar tiden från vilken SMS:et ska skickas - Måste vara en **UNIX-tidsstämpel (GMT 0)**

Exempel:


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

Obs: I händelse av ett leveransfel orsakat av din operatör, försöker en standardfunktion att skicka samma SMS upp till 3 gånger inom ett definierat intervall.

Skicka om ett osänt SMS

Denna API-slutpunkt används för att skicka om ett osänt SMS (endast om meddelandet har en felstatus)

Slutpunkt:

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

Parameter:

- guid: (obligatoriskt) GUID för meddelandet som ska skickas igen.

Exempel:


        Hämta https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE

Logg över SMS som skickats från API:et

Denna API-slutpunkt används för att hämta loggen över SMS-meddelanden som skickas via API:et.

Slutpunkt:

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

Parameter:

- apikey: (obligatoriskt) Din api-nyckel.

- guid_message: kort av den unika identifieraren för meddelandet som används för sortering och filtrering.

- before: Hämta meddelanden som skickats före denna specifika tidsstämpel eller GUID.

- error_api: Ange `1` (`&error_api=1`) för att lista alla SMS som stötte på ett fel under API-begäran.

- error_mobile: Ange `1` (`&error_mobile=1`) för att lista alla SMS som stötte på ett fel under den mobila bearbetningen.

- keyword: Ett nyckelord för att filtrera meddelanden baserat på mottagarens nummer eller SMS-innehåll.

Exempel:


        HÄMTA https://api.smsmobileapi.com/log/sent/sms?apikey=DIN_API_KEY

SMS mottaget

Denna API-slutpunkt används för att hämta SMS-meddelanden som tas emot på smarttelefonen.

Slutpunkt:

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

Parameter:

- apikey: API-nyckeln du har eller kommer att få.

Exempel:


        Hämta https://api.smsmobileapi.com/getsms/?apikey=DIN_API_KEY

Ta bort SMS

Denna API-slutpunkt används för att radera SMS-meddelanden från serverloggen för SMS Mobile API

Slutpunkt:

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

Parameter:

- apikey: API-nyckeln du har.

- guid_message: Det unika ID:t för meddelandet som ska raderas.

- date_start: Om den används ensam, raderas alla meddelanden från den angivna dagen.

- date_start and date_end: Kombineras för att radera meddelanden inom en angiven period.

Exempel:


        Hämta https://api.smsmobileapi.com/deletesms/?apikey=DIN_API_KEY

Obs: De raderade SMS:na är bara de som lagras i loggarna för ditt mobilappkonto. SMS på själva mobilenheten kommer inte att raderas, då vi inte har tillgång till dem.

Webhook – SMS Received

Detta webhook-system skickar en POST-förfrågan till den konfigurerade URL:en när ett SMS tas emot. Systemet säkerställer uppdateringar i realtid genom att skicka SMS-detaljerna till den angivna webhook-URL.

Så här konfigurerar du Webhook i instrumentpanelen

Följ dessa steg för att ställa in din webhook-URL i instrumentpanelen:

Logga in på ditt konto på SMS Mobile API Dashboard.
Navigera till Webhook-inställningar avsnitt.
Ange din webhook-URL (t.ex. https://example.com/webhook-endpoint
Klicka på Spara Webhook knapp.
När det har sparats kommer systemet att börja skicka SMS-detaljer till den konfigurerade URL:en.

Webhook nyttolast

När ett SMS tas emot skickar systemet följande JSON-nyttolast till din webhook-URL:

{

    "date": "2025-01-20",

    "hour": "10:15:00",

    "time_received": "2025-01-20 10:14:50",

    "message": "Hej, detta är ett test.",

    "nummer": "+123456789",

    "guid": "abcde12345"

}

Nyttolastfält:

datum: Datum då SMS:et lades till (ÅÅÅÅ-MM-DD).
timme: Timme när SMS:et lades till (TT:mm:ss).
time_received: Tidpunkt då sms:et togs emot.
meddelande: Innehållet i SMS.
antal: Avsändarens telefonnummer.
guide: Unik identifierare för SMS.

Exempel Webhook Endpoint

Din server bör vara redo att hantera inkommande POST-förfrågningar. Nedan är ett exempel på ett PHP-skript för att bearbeta webhook-nyttolasten:

<?php

// Läs den inkommande nyttolasten

$payload = file_get_contents('php://input');

$data = json_decode($payload, true);




// Bearbeta SMS-data

if ($data) {

    // Exempel: Logga SMS-data till en fil

    file_put_contents('sms_log.txt', print_r($data, true), FILE_APPEND);




    // Svara med HTTP 200-status

    http_response_code(200);

    echo "Webhook mottogs framgångsrikt.";

} annat {

    // Svara med HTTP 400-status för dåliga förfrågningar

    http_response_code(400);


    echo "Ogiltig nyttolast.";

}

?>

Testar Webhook

För att testa din webhook-konfiguration, använd verktyg som:

Dessa verktyg låter dig inspektera nyttolasten som skickas av systemet och felsöka eventuella problem med din webhook-installation.

Felsökning

Se till att webbhook-adressen är korrekt och tillgänglig för allmänheten.
Kontrollera att din server returnerar en HTTP 200-statuskod för lyckade förfrågningar.
Kontrollera dina serverloggar för eventuella fel vid bearbetning av nyttolasten.

Autentisering

SMSMobile API stöder två autentiseringsmetoder: att använda en enkel API-nyckel eller OAuth2-protokollet med ett klient-ID och klienthemlighet.

1. API-nyckelautentisering

Denna metod kräver en API-nyckel som kan inkluderas som en parameter i antingen en GET- eller POST-begäran. Det är ett enkelt sätt att autentisera dina API-förfrågningar.

2. OAuth2-autentisering

OAuth2 ger en säkrare och skalbarare autentiseringsmetod.
Du måste använda ett klient-ID och klienthemlighet för att få en åtkomsttoken, som sedan ska inkluderas i dina API-förfrågningar med hjälp av Tillstånd rubrik.

Client_id och client_secret är tillgängliga i din instrumentpanel, tillgängliga efter att du har installerat appen och skapat ett konto på din mobila enhet.
Ladda ner mobilappen nu eller komma åt din instrumentpanel.

Skaffa en åtkomsttoken

För att få en åtkomsttoken, skicka en POST-begäran till tokenslutpunkten med ditt klient-ID och klienthemlighet.


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=1ab0ex4b4c1ef2c800690d" \

-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"

Använda åtkomsttoken:

När du har tillgångstoken, inkludera den i Tillstånd rubriken för dina API-förfrågningar:


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

-H "Auktorisering: Bärare abc123xyz456" \

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

-d "recipients=+1234567890" \

-d "meddelande=Hej"

Vilken metod ska du använda?

- Använd API-nyckelautentisering för snabba och enkla integrationer.

- Använd OAuth2-autentisering för ökad säkerhet och skalbarhet i dina integrationer.

För mer information, se den fullständiga dokumentationen.

Skicka SMS

WSDL URL

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

Parametrar:

- recipients: Mottagarens mobilnummer.

- message: Meddelandet att skicka. (Meddelandelängden är inte begränsad till 160 tecken; du kan skicka längre meddelanden)

- apikey: API-nyckeln du har eller kommer att få.

Exempel


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

Skicka SMS och WhatsApp

Grundläggande cURL-kommando

Du kan använda följande cURL-kommando för att skicka ett SMS via SMSmobileAPI:


        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"

cURL-exempel i PHP

Om du använder PHP, så här kan du skicka ett SMS med cURL:


        <?php

        

        $url = 'https://api.smsmobileapi.com/sendsms/';

        $data = array(

            'recipients' => 'PHONE_NUMBER',

            'message' => 'YOUR_MESSAGE',

            'apikey' => 'YOUR_API_KEY'

		    'sendwa' => '1'

		    'sendsms' => '1'

        );

        

        $options = array(

            CURLOPT_URL => $url,

            CURLOPT_POST => true,

            CURLOPT_POSTFIELDS => http_build_query($data),

            CURLOPT_RETURNTRANSFER => true,

        );

        

        $ch = curl_init();

        curl_setopt_array($ch, $options);

        $response = curl_exec($ch);

        curl_close($ch);

        

        echo $response;

        

        ?>

Det här PHP-exemplet visar hur man skickar en POST-begäran med hjälp av cURL till SMSmobileAPI, och skickar de nödvändiga parametrarna som en associativ array.

Skicka SMS och WhatsApp

Använd vår officiella Python-modul: https://smsmobileapi.com/python/
eller använd det manuella sättet...

Använda `requests`-biblioteket

Biblioteket `requests` är ett populärt och enkelt HTTP-bibliotek för Python. Så här kan du använda den för att skicka ett SMS via SMSmobileAPI:


        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)

Det här exemplet visar en enkel POST-begäran till SMSmobileAPI, som skickar ett meddelande till ett specifikt telefonnummer.

Använda `http.client`-biblioteket

`http.client`-biblioteket ingår i Pythons standardbibliotek och kan också användas för att interagera med ditt API:


        import http.client

        import urllib.parse



        conn = http.client.HTTPSConnection("api.smsmobileapi.com")



        params = urllib.parse.urlencode({

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        })



        headers = { "Content-type": "application/x-www-form-urlencoded" }



        conn.request("POST", "/sendsms/", params, headers)

        response = conn.getresponse()

        data = response.read()



        print(data.decode("utf-8"))

        conn.close()

Det här exemplet visar hur du använder `http.client`-biblioteket för att skicka en POST-begäran till API:et. Parametrarna är URL-kodade och skickas med lämpliga rubriker.

SMS Mobile API - PHP SDK (Kompositör)

SMS Mobile API PHP SDK är tillgängligt via Composer, vilket gör det enkelt att integrera SMS-sändning i dina PHP-applikationer.


		kompositör kräver smsmobileapi/sdk

För detaljerad dokumentation, installationsinstruktioner och användningsexempel, besök vårt GitHub-förråd:

🔗 SMS Mobile API PHP SDK on GitHub : https://github.com/SmsMobileApi/smsmobileapi-php/tree/main

På GitHub hittar du:
✔️ Full installation guide
✔️ Example usage
✔️ API reference and best practices

Need help? Feel free to open an issue on GitHub! 🎯

Skicka SMS och WhatsApp

Använder "fetch" API

`fetch` API är ett modernt och mångsidigt sätt att göra HTTP-förfrågningar i JavaScript. Så här kan du använda den för att skicka ett SMS via SMSmobileAPI:


        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(response => response.text())

        .then(result => console.log(result))

        .catch(error => console.error("Error:", error));

Det här exemplet visar hur man skickar en POST-förfrågan med hjälp av "fetch" API, som stöds i de flesta moderna webbläsare.

Använder `XMLHttpRequest`

Om du behöver stödja äldre webbläsare kan du använda objektet `XMLHttpRequest`:


        const xhr = new XMLHttpRequest();

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



        const data = "recipients=PHONE_NUMBER&message=YOUR_MESSAGE&apikey=YOUR_API_KEY";



        xhr.open("POST", url, true);

        xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");



        xhr.onreadystatechange = function() {

            if (xhr.readyState === 4 && xhr.status === 200) {

                console.log(xhr.responseText);

            }

        };



        xhr.send(data);

Det här exemplet visar hur du använder `XMLHttpRequest` för att skicka en POST-begäran, vilket ger kompatibilitet med äldre webbläsare som kanske inte stöder `fetch`.

Skicka SMS och WhatsApp

Använda `axios`-biblioteket

`axios`-biblioteket är en populär HTTP-klient för Node.js. Så här kan du använda den för att skicka ett SMS via SMSmobileAPI:


        const axios = require('axios');



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

        const data = {

            recipients: 'PHONE_NUMBER',

            message: 'YOUR_MESSAGE',

            apikey: 'YOUR_API_KEY'

        };



        axios.post(url, data)

        .then(response => {

            console.log(response.data);

        })

        .catch(error => {

            console.error('Error:', error);

        });

Det här exemplet visar hur man skickar en POST-förfrågan med hjälp av `axios` i Node.js för att interagera med SMSmobileAPI.

Skicka SMS och WhatsApp

Använda `Net::HTTP`-biblioteket

Du kan använda `Net::HTTP`-biblioteket i Ruby för att skicka ett SMS via SMSmobileAPI:


        require 'net/http'

        require 'uri'



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

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

        request.set_form_data(

            "recipients" => "PHONE_NUMBER",

            "message" => "YOUR_MESSAGE",

            "apikey" => "YOUR_API_KEY"

        )



        req_options = {

            use_ssl: uri.scheme == "https",

        }



        response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|

            http.request(request)

        end



        puts response.body

Det här exemplet visar hur man skickar en POST-förfrågan med `Net::HTTP` i Ruby till SMSmobileAPI.

Du kan bara skicka WhatsApp-meddelanden via vårt API. Klicka här för att lära dig mer.

Om du har några frågor, förslag eller behöver hjälp finns vårt team här för att hjälpa dig.
Kontakta oss gärna på api@smsmobileapi.com

Klicka här för att testa API-nyckeln och tjänsten med det enkla formuläret

Beroende på vilken version av Android som är installerad på en mobiltelefon, kan operativsystemet hindra att automatiskt skicka och ta emot SMS-meddelanden fungerar korrekt när SmsMobileApi-applikationen inte är i förgrunden.
Det här problemet uppstår från en process som försöker köras i bakgrunden när programmet inte startas aktivt. På grund av Androids batterioptimeringsåtgärder, som varierar mellan olika versioner, kanske denna bakgrundsprocess inte initieras korrekt. Androids batterioptimering är utformad för att begränsa appars bakgrundsaktivitet för att spara batteritid, vilket oavsiktligt kan påverka appar som kräver bakgrundsprocesser för att fungera korrekt.

För att lösa detta problem kan användare manuellt konfigurera sina Android-inställningar så att SmsMobileApi kan använda resurser utan begränsningar.
Detta innebär att justera batterioptimeringsinställningarna för den specifika appen, i huvudsak instruera Android att SmsMobileApi får köras i bakgrunden och använda resurser efter behov. Genom att göra det ska applikationen automatiskt kunna skicka och ta emot SMS även när den inte är den aktiva applikationen i förgrunden. Denna justering säkerställer att den nödvändiga bakgrundsprocessen kan fungera oavbrutet, och kringgår batterioptimeringsfunktionerna som annars skulle kunna förhindra att den utförs korrekt.

FAQ för utvecklare

Hur genererar man en API-nyckel?

Dragspelsprovbeskrivning För att generera en API-nyckel, ladda ner vår applikation till din mobiltelefon och skapa ett konto utan kostnad. En API-nyckel kommer automatiskt att genereras och länkas till din mobiltelefon. Du kommer också att få ett e-postmeddelande med all nödvändig information. Denna process säkerställer att du snabbt och enkelt kan börja använda våra tjänster med minimal installation.

Var kan jag alltid hitta min API-nyckel?

I din mobilapplikation navigerar du till menyn INSTÄLLNINGAR eller HJÄLP, där din API-nyckel är synlig hela tiden. Detta säkerställer att du enkelt kan komma åt din API-nyckel när du behöver den för att integrera eller använda våra tjänster.

Kan skapandet av en API-nyckel vara anonym?

Ja, vi kräver inga bevis på identitet för att skapa en API-nyckel. Kommunikationen mellan vårt API och din mobiltelefon är därför 100% anonym. Detta tillvägagångssätt tillåter användare att behålla sin integritet samtidigt som de använder våra tjänster.

Kom igång med SMSmobileAPI idag!

Upplev friheten och flexibiliteten i att hantera dina SMS-tjänster när du är på språng. Ladda ner vår mobilapp nu och ta första steget mot sömlös SMS-integration.

Ladda ner appen

SMS-dokumentation

Skicka SMS

Skicka osänt SMS igen

LOGG SMS skickat

Få SMS mottaget

Ta bort SMS

SMS mottaget - Webhook

Autentisering

Skicka SMS

Slutpunkt:

Parametrar:

Exempel:

Skicka om ett osänt SMS

Slutpunkt:

Parameter:

Exempel:

Logg över SMS som skickats från API:et

Slutpunkt:

Parameter:

Exempel:

SMS mottaget

Slutpunkt:

Parameter:

Exempel:

Ta bort SMS

Slutpunkt:

Parameter:

Exempel:

Webhook – SMS Received

Så här konfigurerar du Webhook i instrumentpanelen

Webhook nyttolast

Nyttolastfält:

Exempel Webhook Endpoint

Testar Webhook

Felsökning

Autentisering

1. API-nyckelautentisering

2. OAuth2-autentisering

Skaffa en åtkomsttoken

Använda åtkomsttoken:

Vilken metod ska du använda?

Skicka SMS

WSDL URL

Parametrar:

Exempel

Skicka SMS och WhatsApp

Grundläggande cURL-kommando

cURL-exempel i PHP

Skicka SMS och WhatsApp

Använda `requests`-biblioteket

Använda `http.client`-biblioteket

SMS Mobile API - PHP SDK (Kompositör)

Skicka SMS och WhatsApp

Använder "fetch" API

Använder `XMLHttpRequest`

Skicka SMS och WhatsApp

Använda `axios`-biblioteket

Skicka SMS och WhatsApp

Använda `Net::HTTP`-biblioteket

FAQ för utvecklare

Hur genererar man en API-nyckel?

Var kan jag alltid hitta min API-nyckel?

Kan skapandet av en API-nyckel vara anonym?

Kom igång med SMSmobileAPI idag!