Dev DOC - SMSMobileAPI

SMSmobileAPI Developer Documentation

Bij SMSmobileAPI streven we ernaar om onze API zo compatibel mogelijk te maken met elke architectuur of elk platform.
Of u nu REST, SOAP, cURL of verschillende programmeertalen zoals Python, JavaScript, PHP en meer gebruikt, onze API is ontworpen om naadloos te integreren in uw projecten.

Wij hebben ook kant-en-klare plugins voor e-commerce oplossingen en software. Klik hier om ze te ontdekken.

Als u vragen, suggesties of hulp nodig hebt, staat ons team voor u klaar.
Neem gerust contact met ons op via api@smsmobileapi.com

API-REST

cURL

Javascript-functie

Python

Node.js

Robijn

WSDL

SMS-API verzenden

Met dit API-eindpunt kan een sms worden verzonden via een HTTP-verzoek vanaf de smartphone.

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

Parameters:

- recipients: Het mobiele nummer van de ontvanger.

- bericht: het bericht dat moet worden verzonden.

- apikey: De API-sleutel die u heeft of gaat ontvangen.

Opmerking:

Vanwege verplichtingen met betrekking tot telefoongebruik en het beleid van Android, moeten we de vertraging tussen het verzenden van twee sms-berichten vergroten als de applicatie op de achtergrond draait of gesloten is. SMS-berichten kunnen nog steeds worden verzonden, zelfs als de mobiele applicatie gesloten is, maar dit zal resulteren in een langere verzendvertraging.

Ontvang SMS-API

Dit API-eindpunt wordt gebruikt om op de smartphone ontvangen SMS-berichten op te halen.

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

Parameter:

- apikey: de API-sleutel.

SMS versturen

WSDL-URL

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

Parameters:

- recipients: Het mobiele nummer van de ontvanger.

- bericht: het bericht dat moet worden verzonden.

- apikey: De API-sleutel die u heeft of gaat ontvangen.

Voorbeeld

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

SMS versturen

Basis cURL-opdracht

U kunt de volgende cURL-opdracht gebruiken om een SMS te versturen via de SMSmobileAPI:

 curl -X POST https://api.smsmobileapi.com/sendsms/ \
 -d "recipients=PHONE_NUMBER" \
 -d "message=YOUR_MESSAGE" \
 -d "apikey=YOUR_API_KEY"

cURL-voorbeeld in PHP

Als u PHP gebruikt, kunt u als volgt een SMS versturen met 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;
 
 ?>

Dit PHP-voorbeeld laat zien hoe u een POST-verzoek met behulp van cURL naar de SMSmobileAPI kunt verzenden, waarbij de benodigde parameters als een associatieve array worden doorgegeven.

SMS versturen

Gebruik onze officiële Python-module: https://smsmobileapi.com/python/
of gebruik de handmatige manier ...

De bibliotheek `aanvragen` gebruiken

De `requests`-bibliotheek is een populaire en eenvoudige HTTP-bibliotheek voor Python. Hier leest u hoe u deze kunt gebruiken om een SMS te versturen via de 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)

Dit voorbeeld toont een eenvoudige POST-aanvraag aan de SMSmobileAPI, waarmee een bericht naar een specifiek telefoonnummer wordt verzonden.

De `http.client`-bibliotheek gebruiken

De `http.client`-bibliotheek is opgenomen in de standaardbibliotheek van Python en kan ook worden gebruikt om te communiceren met uw 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()

Dit voorbeeld laat zien hoe u de bibliotheek `http.client` gebruikt om een POST-verzoek naar de API te sturen. De parameters zijn URL-gecodeerd en worden verzonden met de juiste headers.

SMS versturen

De `fetch` API gebruiken

De `fetch` API is een moderne en veelzijdige manier om HTTP-verzoeken in JavaScript te maken. Hier is hoe u het kunt gebruiken om een SMS te versturen via de 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));

Dit voorbeeld laat zien hoe u een POST-verzoek verzendt met behulp van de `fetch`-API, die door de meeste moderne browsers wordt ondersteund.

`XMLHttpRequest` gebruiken

Als u oudere browsers moet ondersteunen, kunt u het object `XMLHttpRequest` gebruiken:

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

Dit voorbeeld laat zien hoe u `XMLHttpRequest` kunt gebruiken om een POST-verzoek te verzenden. Dit zorgt voor compatibiliteit met oudere browsers die `fetch` mogelijk niet ondersteunen.

SMS versturen

De `axios`-bibliotheek gebruiken

De `axios`-bibliotheek is een populaire HTTP-client voor Node.js. Zo kunt u deze gebruiken om een SMS te versturen via de 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);
 });

Dit voorbeeld laat zien hoe u een POST-verzoek kunt verzenden met behulp van `axios` in Node.js om te communiceren met de SMSmobileAPI.

SMS versturen

De `Net::HTTP`-bibliotheek gebruiken

U kunt de bibliotheek `Net::HTTP` in Ruby gebruiken om een SMS te versturen via de 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

Dit voorbeeld laat zien hoe u een POST-verzoek met behulp van `Net::HTTP` in Ruby naar de SMSmobileAPI kunt verzenden.

Klik hier om de API-sleutel en service te testen met het eenvoudige formulier

Afhankelijk van de versie van Android die op een mobiele telefoon is geïnstalleerd, kan het besturingssysteem de goede werking van het automatisch verzenden en ontvangen van sms-berichten belemmeren wanneer de applicatie SmsMobileApi niet op de voorgrond staat.
Dit probleem komt voort uit een proces dat op de achtergrond probeert uit te voeren wanneer de applicatie niet actief wordt gestart. Vanwege de batterijoptimalisatiemaatregelen van Android, die per versie variëren, wordt dit achtergrondproces mogelijk niet correct gestart. De batterij-optimalisatie van Android is ontworpen om de achtergrondactiviteit van apps te beperken om de levensduur van de batterij te verlengen, wat onbedoeld invloed kan hebben op apps waarvoor achtergrondprocessen nodig zijn om goed te kunnen functioneren.

Om dit probleem op te lossen, kunnen gebruikers hun Android-instellingen handmatig configureren, zodat de SmsMobileApi bronnen zonder beperkingen kan gebruiken.
Dit omvat het aanpassen van de batterij-optimalisatie-instellingen voor de specifieke app, waarbij Android in wezen wordt geïnstrueerd dat de SmsMobileApi op de achtergrond mag draaien en indien nodig bronnen mag gebruiken. Door dit te doen, moet de applicatie automatisch SMS-berichten kunnen verzenden en ontvangen, zelfs als deze niet de actieve applicatie op de voorgrond is. Deze aanpassing zorgt ervoor dat het noodzakelijke achtergrondproces ononderbroken kan werken, waardoor de batterijoptimalisatiefuncties worden omzeild die anders de juiste uitvoering ervan zouden kunnen belemmeren.

Veelgestelde vragen voor ontwikkelaar

Hoe genereer ik een API-sleutel?

Accordeon VoorbeeldbeschrijvingOm een API-sleutel te genereren, downloadt u onze applicatie naar uw mobiele telefoon en maakt u gratis een account aan. Er wordt automatisch een API-sleutel gegenereerd en aan uw mobiele telefoon gekoppeld. Ook ontvang je een e-mail met alle benodigde informatie. Dit proces zorgt ervoor dat u snel en eenvoudig met minimale installatie aan de slag kunt met het gebruik van onze diensten.

Waar kan ik altijd mijn API-sleutel vinden?

Navigeer in uw mobiele applicatie naar het menu INSTELLINGEN of HELP, waar uw API-sleutel altijd zichtbaar is. Dit zorgt ervoor dat u eenvoudig toegang heeft tot uw API-sleutel wanneer u deze nodig heeft voor de integratie of het gebruik van onze diensten.

Kan het aanmaken van een API-sleutel anoniem zijn?

Ja, voor het aanmaken van een API-sleutel hebben wij geen identiteitsbewijs nodig. De communicatie tussen onze API en je mobiele telefoon is daardoor 100% anoniem. Met deze aanpak kunnen gebruikers hun privacy behouden terwijl ze onze services gebruiken.

Ga vandaag nog aan de slag met SMSmobileAPI!

Ervaar de vrijheid en flexibiliteit van het onderweg beheren van uw sms-diensten. Download nu onze mobiele app en zet de eerste stap naar een naadloze sms-integratie.

Download de app