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

krul

Javascript-functie

Python

Node.js

Robijn

WSDL

API voor het verzenden van SMS

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

Parameters:

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

Ontvang SMS API

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

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

Parameter:

- ontvangers: Het mobiele nummer van de ontvanger.

- bericht: Het bericht dat verzonden moet worden.

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

SMS API verwijderen

Dit API-eindpunt wordt gebruikt om SMS-berichten te verwijderen uit het serverlogboek van SMS Mobile API

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

Parameter:

- apikey: De API-sleutel die u heeft.

- guid_message: De unieke ID van het bericht dat moet worden verwijderd.

- date_start: Als u deze alleen gebruikt, worden alle berichten van de opgegeven dag verwijderd.

- date_start en date_end: gecombineerd om berichten binnen een bepaalde periode te verwijderen.

Let op: De verwijderde SMS-berichten zijn alleen die welke zijn opgeslagen in de logs van uw mobiele app-account. SMS-berichten op het mobiele apparaat zelf worden niet verwijderd, omdat wij er geen toegang toe hebben.

SMS versturen

WSDL-URL

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

Parameters:

- ontvangers: Het mobiele nummer van de ontvanger.

- bericht: Het bericht dat verzonden moet worden.

- apikey: De API-sleutel die u heeft of zult 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. Zo kunt u deze 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 juiste werking van het automatisch verzenden en ontvangen van sms-berichten belemmeren wanneer de applicatie SmsMobileApi niet op de voorgrond staat.
Dit probleem ontstaat door een proces dat op de achtergrond probeert te draaien wanneer de applicatie niet actief wordt gestart. Vanwege de batterij-optimalisatiemaatregelen van Android, die per versie verschillen, kan dit achtergrondproces echter niet correct worden gestart. De batterij-optimalisatie van Android is ontworpen om de achtergrondactiviteit van apps te beperken om de batterij te sparen, wat onbedoeld van invloed kan zijn op apps die achtergrondprocessen nodig hebben om goed te functioneren.

Om dit probleem te verhelpen, kunnen gebruikers hun Android-instellingen handmatig configureren, zodat de SmsMobileApi bronnen zonder beperkingen kan gebruiken.
Dit houdt in dat de batterij-optimalisatie-instellingen voor de specifieke app worden aangepast, waarbij Android in feite wordt geïnstrueerd dat de SmsMobileApi op de achtergrond mag draaien en bronnen mag gebruiken als dat nodig is. Door dit te doen, zou de applicatie automatisch sms-berichten moeten kunnen verzenden en ontvangen, zelfs als het niet de actieve applicatie op de voorgrond is. Deze aanpassing zorgt ervoor dat het benodigde achtergrondproces ononderbroken kan werken, waarbij de batterij-optimalisatiefuncties worden omzeild die anders de juiste uitvoering ervan zouden kunnen verhinderen.

FAQ voor ontwikkelaars

Hoe genereer ik een API-sleutel?

Accordion Sample BeschrijvingOm een API-sleutel te genereren, downloadt u onze applicatie op uw mobiele telefoon en maakt u gratis een account aan. Er wordt automatisch een API-sleutel gegenereerd en gekoppeld aan uw mobiele telefoon. U ontvangt ook een e-mail met alle benodigde informatie. Dit proces zorgt ervoor dat u snel en eenvoudig onze services kunt gebruiken met minimale installatie.

Waar kan ik mijn API-sleutel altijd 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 hebt tot uw API-sleutel wanneer u deze nodig hebt voor het integreren of gebruiken van onze services.

Kan een API-sleutel anoniem worden aangemaakt?

Ja, we hebben geen identiteitsbewijs nodig om een API-sleutel te maken. De communicatie tussen onze API en uw mobiele telefoon is daarom 100% anoniem. Deze aanpak stelt gebruikers in staat hun privacy te behouden terwijl ze onze diensten gebruiken.

Ga vandaag nog aan de slag met SMSmobileAPI!

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

Download de app