Dev DOC - SMSMobileAPI

SMS-documentatie

SMSmobileAPI-ontwikkelaarsdocumentatie

Bij SMSmobileAPI streven we ernaar om onze API zo compatibel mogelijk te maken met elke architectuur en 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.

.

API REST

cURL

Composer

JavaScript

Python

Node.js

Robijn

WSDL

SMS verzenden

Met dit eindpunt kunt u een sms-bericht verzenden vanaf uw mobiele telefoon.

Eindpunt:

KRIJGEN NA https://api.smsmobileapi.com/sendsms/

Parameters:

Parameter	Parameter	Beschrijving
apikey	Vereist Uw unieke API-sleutel.
recipients	Vereist Het telefoonnummer van de ontvanger.
message	Vereist Het te verzenden bericht (De berichtlengte is niet beperkt tot 160 tekens; u kunt langere berichten verzenden)
sendwa	1 = het bericht moet via WhatsApp worden verzonden.
sendsms	1 = het bericht moet via een traditionele SMS worden verzonden. (Als sms versturen is leeg: standaard verzonden, ingesteld op 0 om de SMS te blokkeren)
encrypt_message	Ja = Het bericht is gecodeerd wanneer de ontvanger het leest. De ontvanger moet een unieke sleutel invoeren om het bericht te ontsleutelen. Meer informatie over berichtversleuteling
schedule_timestamp	Geeft de tijd weer vanaf wanneer de sms moet worden verzonden. Moet een UNIX-tijdstempel (GMT 0)

Voorbeeld:


        KRIJG https://api.smsmobileapi.com/sendsms?apikey=UW_API_SLEUTEL&recipients=+1234567890&message=HelloWorld

Let op: Als er sprake is van een bezorgfout veroorzaakt door uw provider, wordt standaard geprobeerd hetzelfde sms-bericht maximaal 3 keer binnen een bepaald interval te versturen.

Een niet-verzonden sms opnieuw verzenden

Dit API-eindpunt wordt gebruikt om een niet-verzonden SMS opnieuw te verzenden (alleen als het bericht een foutstatus heeft)

Eindpunt:

KRIJGEN NA https://api.smsmobileapi.com/resend/

Parameter:

Parameter	Beschrijving
guid	Vereist GUID van het bericht dat opnieuw moet worden verzonden.

Voorbeeld:


        KRIJG https://api.smsmobileapi.com/resend/?apikey=UW_API_SLEUTEL&guid=GUID_VAN_HET_BERICHT

Logboek van SMS verzonden via de API

Dit API-eindpunt wordt gebruikt om het logboek op te halen van SMS-berichten die via de API zijn verzonden.

Eindpunt:

KRIJGEN https://api.smsmobileapi.com/log/sent/sms/

Parameter:

Parameter	Beschrijving
apikey	Vereist Uw API-sleutel.
guid_message	Kort gezegd de unieke identificatiecode van het bericht die wordt gebruikt voor het sorteren en filteren.
before	Haal berichten op die vóór dit specifieke tijdstempel of deze GUID zijn verzonden.
error_api	Voer 1 in om alle sms-berichten te tonen waarbij een fout is opgetreden tijdens de API-aanvraag.
error_mobile	Voer 1 in om alle sms-berichten te zien waarbij een fout is opgetreden tijdens de mobiele verwerking.
keyword	Een trefwoord om berichten te filteren op basis van het telefoonnummer van de ontvanger of de SMS-inhoud.

Voorbeeld:


        KRIJG https://api.smsmobileapi.com/log/sent/sms?apikey=UW_API_SLEUTEL

SMS ontvangen

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

Eindpunt:

KRIJGEN https://api.smsmobileapi.com/getsms/

Parameter:

Parameter	Beschrijving
apikey	Vereist De API-sleutel die u heeft of zult ontvangen.

Voorbeeld:


        KRIJG https://api.smsmobileapi.com/getsms/?apikey=UW_API_SLEUTEL

SMS verwijderen

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

Eindpunt:

KRIJGEN https://api.smsmobileapi.com/deletesms/

Parameter:

Parameter	Beschrijving
apikey	Vereist De API-sleutel die u heeft.
guid_message	De unieke ID van het bericht dat u wilt verwijderen.
date_start	Als u deze optie alleen gebruikt, worden alle berichten van de opgegeven dag verwijderd.
date_start and date_end	Gecombineerd om berichten binnen een bepaalde periode te verwijderen.

Voorbeeld:


        KRIJG https://api.smsmobileapi.com/deletesms/?apikey=UW_API_SLEUTEL

Let op: De verwijderde sms-berichten zijn alleen de berichten die 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.

Webhook – SMS ontvangen

Dit webhooksysteem stuurt een POST-verzoek naar de geconfigureerde URL wanneer er een sms-bericht wordt ontvangen. Het systeem zorgt voor realtime updates door de sms-gegevens naar de opgegeven webhook-URL te sturen.

Hoe u de webhook in het dashboard configureert

Volg deze stappen om uw webhook-URL in het dashboard in te stellen:

Meld u aan bij uw account op de SMS Mobiel API Dashboard.
Navigeer naar de Webhook-instellingen sectie.
Voer uw webhook-URL in (bijv. https://example.com/webhook-endpoint
Klik op de Webhook opslaan knop.
Nadat u de gegevens hebt opgeslagen, stuurt het systeem sms-gegevens naar de geconfigureerde URL.

Webhook-payload

Wanneer een SMS wordt ontvangen, stuurt het systeem de volgende JSON-payload naar uw webhook-URL:

{

    "datum": "2025-01-20",

    "uur": "10:15:00",

    "tijd_ontvangen": "2025-01-20 10:14:50",

    "bericht": "Hallo, dit is een test.",

    "nummer": "+123456789",

    "guid": "abcde12345"

}

Payloadvelden:

datum: Datum waarop het SMS-bericht is toegevoegd (JJJJ-MM-DD).
uur: Uur waarop het SMS-bericht is toegevoegd (UU:mm:ss).
tijd_ontvangen: Tijdstip waarop het SMS-bericht is ontvangen.
bericht: Inhoud van het SMS-bericht.
nummer: Telefoonnummer van de afzender.
gids: Unieke identificatie van het SMS-bericht.

Voorbeeld Webhook-eindpunt

Je server zou klaar moeten zijn om inkomende POST-verzoeken te verwerken. Hieronder staat een voorbeeld van een PHP-script om de webhook-payload te verwerken:

<?php

// Lees de binnenkomende payload

$payload = file_get_contents('php://input');

$data = json_decode($payload, true);




// Verwerk de SMS-gegevens

als ($data) {

    // Voorbeeld: SMS-gegevens naar een bestand loggen

    file_put_contents('sms_log.txt', print_r($data, true), FILE_APPEND);




    // Reageer met HTTP 200-status

    http_response_code(200);

    echo "Webhook succesvol ontvangen.";

} anders {

    // Reageer met HTTP 400-status op slechte verzoeken

    http_response_code(400);


    echo "Ongeldige payload.";

}

?>

De webhook testen

Om uw webhookconfiguratie te testen, kunt u de volgende hulpmiddelen gebruiken:

Met deze hulpmiddelen kunt u de door het systeem verzonden payload controleren en eventuele problemen met uw webhook-instellingen opsporen.

Probleemoplossing

Zorg ervoor dat de webhook-URL correct en openbaar toegankelijk is.
Controleer of uw server een HTTP 200-statuscode retourneert voor succesvolle verzoeken.
Controleer de logs van uw server op eventuele fouten bij het verwerken van de payload.

Authenticatie

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

1. API-sleutelauthenticatie

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

2. OAuth2-authenticatie

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 vindt u 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 de toegangstoken hebt, voegt u deze 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-sleutelauthenticatie voor snelle en eenvoudige integraties.

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

Voor meer informatie verwijzen wij u naar de volledige documentatie.

SMS verzenden

WSDL-URL

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

Parameters:

- recipients: Het mobiele nummer van de ontvanger.

- message: Het te verzenden bericht. (De berichtlengte is niet beperkt tot 160 tekens; u kunt langere berichten verzenden.)

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

Stuur SMS & WhatsApp

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" 

		
		 -d "sendwa=1"

		 -d "sendsms=1"

cURL-voorbeeld in PHP

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

        

        ?>

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.

Stuur SMS & WhatsApp

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

De `requests`-bibliotheek gebruiken

De `requests`-bibliotheek is een populaire en eenvoudige HTTP-bibliotheek voor Python. Zo kun je 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 demonstreert een eenvoudige POST-aanvraag naar 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 met uw API te communiceren:


        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 Mobiele API - PHP SDK (Composer)

De SMS Mobile API PHP SDK is beschikbaar via Composer, waardoor u eenvoudig SMS-verzending in uw PHP-applicaties kunt integreren.


		componist vereist smsmobileapi/sdk

Bezoek onze GitHub-repository voor gedetailleerde documentatie, installatie-instructies en gebruiksvoorbeelden:

🔗 SMS Mobile API PHP SDK op GitHub: https://github.com/SmsMobileApi/smsmobileapi-php/tree/main

Op GitHub vindt u:
✔️ Volledige installatiehandleiding
✔️ Voorbeeldgebruik
✔️ API-referentie en best practices

Hulp nodig? Open gerust een probleem op GitHub! 🎯

Stuur SMS & WhatsApp

De `fetch` API gebruiken

De `fetch` API is een moderne en veelzijdige manier om HTTP-verzoeken in JavaScript te doen. Zo kun je deze 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 versturen. Dit zorgt voor compatibiliteit met oudere browsers die `fetch` mogelijk niet ondersteunen.

Stuur SMS & WhatsApp

De `axios`-bibliotheek gebruiken

De `axios`-bibliotheek is een populaire HTTP-client voor Node.js. Zo kun je 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.

Stuur SMS & WhatsApp

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

U kunt WhatsApp-berichten alleen via onze API versturen. Klik hier voor meer informatie.

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

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

Afhankelijk van de Android-versie die op een mobiele telefoon is geïnstalleerd, kan het besturingssysteem de juiste werking van het automatisch verzenden en ontvangen van sms-berichten belemmeren als de applicatie SmsMobileApi niet op de voorgrond staat.
Dit probleem wordt veroorzaakt door een proces dat op de achtergrond probeert te draaien wanneer de app niet actief is gestart. Vanwege de batterij-optimalisatiemaatregelen van Android, die per versie verschillen, wordt dit achtergrondproces echter mogelijk niet correct gestart. De batterij-optimalisatie van Android is ontworpen om de achtergrondactiviteit van apps te beperken om de batterij te sparen. Dit kan onbedoeld van invloed zijn op apps die achtergrondprocessen nodig hebben om goed te functioneren.

Om dit probleem te verhelpen, kunnen gebruikers de 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. Android krijgt hiermee in feite de instructie dat de SmsMobileApi op de achtergrond mag draaien en resources mag gebruiken wanneer dat nodig is. Hierdoor zou de applicatie automatisch sms-berichten moeten kunnen verzenden en ontvangen, zelfs wanneer deze niet de actieve applicatie op de voorgrond is. Deze aanpassing zorgt ervoor dat het benodigde achtergrondproces ononderbroken kan werken, waardoor de batterij-optimalisatiefuncties worden omzeild die anders de correcte uitvoering ervan zouden kunnen verhinderen.

Veelgestelde vragen voor ontwikkelaars

Hoe genereer ik een API-sleutel?

Beschrijving van het accordeonvoorbeeld: Om 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 met minimale installatie aan de slag kunt met onze diensten.

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. Zo heeft u altijd eenvoudig toegang tot uw API-sleutel wanneer u deze nodig hebt om onze diensten te integreren of te gebruiken.

Kan een API-sleutel anoniem worden aangemaakt?

Ja, we hebben geen identiteitsbewijs nodig voor het aanmaken van een API-sleutel. De communicatie tussen onze API en uw mobiele telefoon is daarom 100% anoniem. Deze aanpak stelt gebruikers in staat hun privacy te behouden tijdens het gebruik van onze diensten.

Begin vandaag nog 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

SMS-functies

WhatsApp-functies

Algemene plug-ins

Online winkel plug-ins

API- en ontwikkelaarsdocumentatie

Logboek met hulpmiddelen en wijzigingen

SMS-documentatie

SMS verzenden

Niet-verzonden SMS opnieuw verzenden

LOG SMS verzonden

Ontvangen sms

SMS verwijderen

SMS ontvangen - Webhook

Authenticatie

SMS verzenden

Eindpunt:

Parameters:

Voorbeeld:

Een niet-verzonden sms opnieuw verzenden

Eindpunt:

Parameter:

Voorbeeld:

Logboek van SMS verzonden via de API

Eindpunt:

Parameter:

Voorbeeld:

SMS ontvangen

Eindpunt:

Parameter:

Voorbeeld:

SMS verwijderen

Eindpunt:

Parameter:

Voorbeeld:

Webhook – SMS ontvangen

Hoe u de webhook in het dashboard configureert

Webhook-payload

Payloadvelden:

Voorbeeld Webhook-eindpunt

De webhook testen

Probleemoplossing

Authenticatie

1. API-sleutelauthenticatie

2. OAuth2-authenticatie

Een toegangstoken verkrijgen

Het toegangstoken gebruiken:

Welke methode moet u gebruiken?

SMS verzenden

WSDL-URL

Parameters:

Voorbeeld

Stuur SMS & WhatsApp

Basis cURL-opdracht

cURL-voorbeeld in PHP

Stuur SMS & WhatsApp

De `requests`-bibliotheek gebruiken

De `http.client`-bibliotheek gebruiken

SMS Mobiele API - PHP SDK (Composer)

Stuur SMS & WhatsApp

De `fetch` API gebruiken

`XMLHttpRequest` gebruiken

Stuur SMS & WhatsApp

De `axios`-bibliotheek gebruiken

Stuur SMS & WhatsApp

De `Net::HTTP`-bibliotheek gebruiken

Veelgestelde vragen voor ontwikkelaars

Hoe genereer ik een API-sleutel?

Waar kan ik mijn API-sleutel altijd vinden?

Kan een API-sleutel anoniem worden aangemaakt?

Begin vandaag nog met SMSmobileAPI!