Dev DOC - SMSMobileAPI

SMSmobileAPI Developer Documentation You can send WhatsApp messages only through our API. Click here to learn more.

På SMSmobileAPI strävar vi efter att göra vårt API så kompatibelt som möjligt med vilken arkitektur eller plattform som helst.
Oavsett om du använder REST, SOAP, cURL eller olika programmeringsspråk som Python, JavaScript, PHP och mer, är vårt API utformat för att integreras sömlöst i dina projekt.

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

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

API REST

cURL

JavaScript

Pytonorm

Node.js

Rubin

WSDL

Send SMS & WhatsApp 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

Parametrar:

- apikey: Your unique API key.

- recipients: The recipient's phone number.

- message: The message to send.

- sendwa: 1 = the message must be sent via WhatsApp.

- sendsms: 1 = the message must be sent via a traditional SMS. (If sendsms is empty: sent by default, set to 0 to block the SMS)

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.

Skaffa SMS API

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

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

Parameter:

- recipients: The mobile number of the recipient.

- message: The message to send.

- apikey: The API key you have or will receive.

Ta bort SMS API

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

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

Parameter:

- apikey: The API key you have.

- guid_message: The unique ID of the message to delete.

- date_start: If used alone, deletes all messages from the specified day.

- date_start and date_end: Combined to delete messages within a specified period.

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.

Skicka SMS

WSDL URL

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

Parametrar:

- recipients: The mobile number of the recipient.

- message: The message to send.

- apikey: The API key you have or will receive.

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

Send SMS & 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.

Send SMS & 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.

Send SMS & 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`.

Send SMS & 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.

Send SMS & 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.

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