Dev DOC - SMSMobileAPI

SMS dokumentation

SMSmobileAPI-udviklerdokumentation

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 at integreres problemfrit i dine projekter.

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

.

API REST

cURL

Composer

JavaScript

Python

Node.js

Rubin

WSDL

Send SMS

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

Slutpunkt:

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

Parametre:

- apikey: Din unikke API-nøgle.

- recipients: Modtagerens telefonnummer.

- message: Beskeden der skal sendes (Beskedens længde er ikke begrænset til 160 tegn; du kan sende længere beskeder)

- sendwa: 1 = beskeden skal sendes via WhatsApp.

- sendsms: 1 = beskeden skal sendes via en traditionel SMS. (Hvis sendsms er tom: sendes som standard, indstillet til 0 for at blokere SMS'en)

- schedule_timestamp = Repræsenterer det tidspunkt, hvorfra SMS'en skal sendes - Skal være et **UNIX-tidsstempel (GMT 0)**

Eksempel:


        FÅ 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 at sende den samme SMS op til 3 gange inden for et defineret interval.

Gensend en ikke-sendt SMS

Dette API-slutpunkt bruges til at gensende en ikke-sendt SMS (kun hvis beskeden har en fejlstatus)

Slutpunkt:

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

Parameter:

- guid: (påkrævet) GUID for den besked, der skal sendes igen.

Eksempel:


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

Log over SMS sendt fra API'et

Dette API-slutpunkt bruges til at hente loggen over SMS-beskeder sendt via API'et.

Slutpunkt:

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

Parameter:

- apikey: (påkrævet) Din api-nøgle.

- guid_message: kort af den unikke identifikator for meddelelsen, der bruges til sortering og filtrering.

- before: Hent beskeder sendt før dette specifikke tidsstempel eller GUID.

- error_api: Indtast `1` (`&error_api=1`) for at liste alle SMS'er, der stødte på en fejl under API-anmodningen.

- error_mobile: Indtast `1` (`&error_mobile=1`) for at liste alle SMS'er, der stødte på en fejl under mobilbehandlingen.

- keyword: Et nøgleord til at filtrere beskeder baseret på modtagerens nummer eller SMS-indhold.

Eksempel:


        FÅ https://api.smsmobileapi.com/log/sent/sms?apikey=DIN_API_KEY

SMS modtaget

Dette API-slutpunkt bruges til at hente SMS-beskeder modtaget på smartphonen.

Slutpunkt:

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

Parameter:

- apikey: API-nøglen du har eller vil modtage.

Eksempel:


        FÅ https://api.smsmobileapi.com/getsms/?apikey=DIN_API_KEY

Slet SMS

Dette API-slutpunkt bruges til at slette SMS-beskeder fra serverloggen for SMS Mobile API

Slutpunkt:

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

Parameter:

- apikey: Den API-nøgle du har.

- guid_message: Det unikke ID for den besked, der skal slettes.

- date_start: Hvis det bruges alene, sletter alle beskeder fra den angivne dag.

- date_start and date_end: Kombineret for at slette beskeder inden for en bestemt periode.

Eksempel:


        FÅ https://api.smsmobileapi.com/deletesms/?apikey=DIN_API_KEY

Bemærk: De slettede SMS'er er kun dem, der er gemt i logfilerne på din mobilappkonto. SMS på selve mobilenheden bliver ikke slettet, da vi ikke har adgang til dem.

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

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

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

    "message": "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:

<?php

// Læs den indgående nyttelast

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

$data = json_decode($payload, sand);




// Behandle SMS-dataene

if ($data) {

    // Eksempel: Log SMS-data til en fil

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




    // Svar med HTTP 200-status

    http_responskode(200);

    echo "Webhook modtaget med succes.";

} andet {

    // Svar med HTTP 400-status for dårlige anmodninger

    http_responskode(400);


    echo "Ugyldig nyttelast.";

}

?>

Test af Webhook

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

Disse værktøjer giver dig mulighed for at inspicere nyttelasten sendt af systemet og fejlfinde eventuelle problemer med din webhook-opsætning.

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.

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. Det er en ligetil måde at autentificere dine API-anmodninger på.

2. OAuth2-godkendelse

OAuth2 giver en mere sikker og skalerbar godkendelsesmetode.
Du skal bruge et klient-id og klienthemmelighed for at få et adgangstoken, som derefter skal inkluderes i dine API-anmodninger ved hjælp af Bemyndigelse overskrift.

Client_id og client_secret er tilgængelige i dit dashboard, tilgængelige efter installation af appen og oprettelse af en konto på din mobilenhed.
Download mobilappen nu eller få adgang til dit dashboard.

Få et adgangstoken

For at få et adgangstoken skal du sende en POST-anmodning til tokenslutpunktet med dit klient-id og klienthemmelighed.


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"

Brug af adgangstoken:

Når du har adgangstokenet, skal du inkludere det i Bemyndigelse overskriften på dine API-anmodninger:


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

-H "Autorisation: Bearer abc123xyz456" \

-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 øget sikkerhed og skalerbarhed i dine integrationer.

For flere detaljer henvises til den fulde dokumentation.

Send SMS

WSDL URL

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

Parametre:

- recipients: Mobilnummeret på modtageren.

- message: Beskeden der skal sendes. (Beskedlængden er ikke begrænset til 160 tegn; du kan sende længere beskeder)

- 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

Du kan bruge følgende cURL-kommando til at sende en 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-eksempel i PHP

Hvis du bruger PHP, kan du her se, hvordan du kan sende en SMS ved hjælp af 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;

        

        ?>

Dette PHP-eksempel demonstrerer, hvordan man sender en POST-anmodning ved hjælp af cURL til SMSmobileAPI'et, og sender de nødvendige parametre som et associativt array.

Send SMS og WhatsApp

Brug vores officielle Python-modul: https://smsmobileapi.com/python/
eller brug den manuelle måde...

Brug af "anmodningsbiblioteket".

Biblioteket `anmodninger` er et populært og enkelt HTTP-bibliotek til Python. Sådan kan du bruge det til at sende en 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)

Dette eksempel viser en simpel POST-anmodning til SMSmobileAPI, der sender en besked til et specifikt telefonnummer.

Brug af `http.client`-biblioteket

`http.client`-biblioteket er inkluderet i standardbiblioteket for Python og kan også bruges til at interagere med din 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()

Dette eksempel viser, hvordan du bruger `http.client`-biblioteket til at sende en POST-anmodning til API'et. Parametrene er URL-kodede og sendes med de relevante overskrifter.

SMS Mobile API - PHP SDK (komponist)

SMS Mobile API PHP SDK er tilgængelig via Composer, hvilket gør det nemt at integrere SMS-afsendelse i dine PHP-applikationer.


		komponist kræver smsmobileapi/sdk

Besøg vores GitHub-lager for detaljeret dokumentation, installationsinstruktioner og brugseksempler:

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

På GitHub finder du:
✔️ Fuld installationsvejledning
✔️ Eksempel på brug
✔️ API-reference og bedste praksis

Har du brug for hjælp? Du er velkommen til at åbne et problem på GitHub! 🎯

Send SMS og WhatsApp

Brug af 'fetch' API

'Fetch' API er en moderne og alsidig måde at lave HTTP-anmodninger i JavaScript. Sådan kan du bruge det til at sende en 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));

Dette eksempel viser, hvordan man sender en POST-anmodning ved hjælp af 'fetch' API, som understøttes i de fleste moderne browsere.

Brug af `XMLHttpRequest`

Hvis du har brug for at understøtte ældre browsere, kan du bruge 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);

Dette eksempel viser, hvordan du bruger `XMLHttpRequest` til at sende en POST-anmodning, hvilket giver kompatibilitet med ældre browsere, der muligvis ikke understøtter `fetch`.

Send SMS og WhatsApp

Brug af `axios`-biblioteket

`axios`-biblioteket er en populær HTTP-klient til Node.js. Sådan kan du bruge det til at sende en 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);

        });

Dette eksempel viser, hvordan man sender en POST-anmodning ved hjælp af `axios` i Node.js for at interagere med SMSmobileAPI.

Send SMS og WhatsApp

Brug af `Net::HTTP`-biblioteket

Du kan bruge `Net::HTTP`-biblioteket i Ruby til at sende en 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

Dette eksempel viser, hvordan man sender en POST-anmodning ved hjælp af `Net::HTTP` i Ruby til SMSmobileAPI.

Du kan kun sende WhatsApp-beskeder gennem vores API. Klik her for at lære mere.

Hvis du har spørgsmål, forslag eller har brug for hjælp, er vores team her for at hjælpe.
Du er velkommen til at kontakte os på api@smsmobileapi.com

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

SMS dokumentation

Send SMS

Send ikke-sendt SMS igen

LOG SMS sendt

Få SMS modtaget

Slet SMS

SMS modtaget - Webhook

Autentificering

Send SMS

Slutpunkt:

Parametre:

Eksempel:

Gensend en ikke-sendt SMS

Slutpunkt:

Parameter:

Eksempel:

Log over SMS sendt fra API'et

Slutpunkt:

Parameter:

Eksempel:

SMS modtaget

Slutpunkt:

Parameter:

Eksempel:

Slet SMS

Slutpunkt:

Parameter:

Eksempel:

Webhook – SMS modtaget

Sådan konfigurerer du Webhook i Dashboard

Webhook nyttelast

Nyttelastfelter:

Eksempel Webhook Endpoint

Test af Webhook

Fejlfinding

Autentificering

1. API-nøglegodkendelse

2. OAuth2-godkendelse

Få et adgangstoken

Brug af adgangstoken:

Hvilken metode skal du bruge?

Send SMS

WSDL URL

Parametre:

Eksempel

Send SMS og WhatsApp

Grundlæggende cURL-kommando

cURL-eksempel i PHP

Send SMS og WhatsApp

Brug af "anmodningsbiblioteket".

Brug af `http.client`-biblioteket

SMS Mobile API - PHP SDK (komponist)

Send SMS og WhatsApp

Brug af 'fetch' API

Brug af `XMLHttpRequest`

Send SMS og WhatsApp

Brug af `axios`-biblioteket

Send SMS og WhatsApp

Brug af `Net::HTTP`-biblioteket

FAQ for udviklere

Hvordan genererer man en API-nøgle?

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

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

Kom godt i gang med SMSmobileAPI i dag!