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

De SMSMobile API ondersteunt twee authenticatiemethoden: met een eenvoudige API-sleutel of met het OAuth2-protocol met een client-ID en clientgeheim.

1. API-sleutelverificatie voor het verzenden van SMS

Deze methode vereist een API-sleutel die kan worden opgenomen als parameter in een GET- of POST-verzoek. Het is een eenvoudige manier om uw API-verzoeken te verifiëren.

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

Parameters:

- aapje: Uw unieke API-sleutel.

- ontvangers: Het telefoonnummer van de ontvanger.

- bericht: Het bericht dat verzonden moet worden.

Voorbeeld:

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

2. OAuth2-verificatie voor het verzenden van sms-berichten

OAuth2 biedt een veiligere en schaalbare authenticatiemethode.
U moet een client-ID en clientgeheim gebruiken om een toegangstoken te verkrijgen, die vervolgens moet worden opgenomen in uw API-aanvragen met behulp van de Autorisatie koptekst.

De client_id en client_secret zijn beschikbaar in uw dashboard. U kunt er toegang toe krijgen nadat u de app hebt geïnstalleerd en een account hebt aangemaakt op uw mobiele apparaat.
Download nu de mobiele app of toegang tot uw dashboard.

Een toegangstoken verkrijgen

Om een toegangstoken te verkrijgen, stuurt u een POST-aanvraag naar het tokeneindpunt met uw client-ID en clientgeheim.

 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"

Het toegangstoken gebruiken:

Zodra u het toegangstoken hebt, voegt u het toe aan de Autorisatie header van uw API-verzoeken:

 curl -X POST https://api.smsmobileapi.com/sendsms \
 -H "Autorisatie: Drager abc123xyz456" \
 -H "Inhoudstype: toepassing/x-www-formulier-urlengecodeerd" \
 -d "ontvangers=+1234567890" \
 -d "bericht=Hallo"

Welke methode moet u gebruiken?

- Gebruik API-sleutelverificatie voor snelle en eenvoudige integraties.

- Gebruik OAuth2-authenticatie voor verbeterde beveiliging en schaalbaarheid in uw integraties.

Voor meer informatie verwijzen wij u naar de volledige documentatie.

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