Dev DOC - SMSMobileAPI

SMSmobileAPI Developer Documentation

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

ringla

JavaScript

Pytonorm

Node.js

Rubin

WSDL

Skicka 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

Parametrar:

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

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:

- mottagare: mottagarens mobilnummer.

- meddelande: Meddelandet som ska skickas.

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

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: API-nyckeln du har.

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

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

- date_start och date_end: Kombinerade för att radera meddelanden inom en angiven 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:

- mottagare: mottagarens mobilnummer.

- meddelande: Meddelandet som ska skickas.

- 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

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"

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

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.

Skicka SMS

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

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

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