Dev DOC - SMSMobileAPI

SMSmobileAPI Developer Documentation

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.

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

API REST

krølle

JavaScript

Python

Node.js

Rubin

WSDL

Send SMS API

The SMSMobile API supports two authentication methods: using a simple API Key or the OAuth2 protocol with a client ID and client secret.

1. API Key Authentication for Send SMS

This method requires an API Key that can be included as a parameter in either a GET or POST request. It is a straightforward way to authenticate your API requests.

https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=PHONE_NUMBER&message=MESSAGE_TO_SEND

Parametre:

- apikey: Your unique API key.

- recipients: The recipient's phone number.

- message: The message to send.

Example:

GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=Hello%20World

2. OAuth2 Authentication for Send SMS

OAuth2 provides a more secure and scalable authentication method.
You will need to use a client ID and client secret to obtain an access token, which should then be included in your API requests using the Authorization header.

The client_id and client_secret are available in your dashboard, accessible after installing the app and creating an account on your mobile device.
Download the mobile app now eller access your dashboard.

Obtaining an Access Token

To get an access token, send a POST request to the token endpoint with your client ID and client secret.

 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"

Using the Access Token:

Once you have the access token, include it in the Authorization header of your API requests:

 curl -X POST https://api.smsmobileapi.com/sendsms \
 -H "Authorization: Bearer abc123xyz456" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d "recipients=+1234567890" \
 -d "message=Hello"

Which Method Should You Use?

- Use API Key Authentication for quick and straightforward integrations.

- Use OAuth2 Authentication for enhanced security and scalability in your integrations.

For more details, please refer to the full documentation.

Hent SMS API

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

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

Parameter:

- modtagere: Mobilnummeret på modtageren.

- besked: Den besked, der skal sendes.

- apikey: Den API-nøgle, du har eller vil modtage.

Slet SMS API

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

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

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 og date_end: Kombineret for at slette beskeder inden for en bestemt periode.

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.

Send SMS

WSDL URL

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

Parametre:

- modtagere: Mobilnummeret på modtageren.

- besked: Den besked, der skal sendes.

- apikey: Den API-nøgle, 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

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"

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

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.

Send SMS

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

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

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.

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