Dev DOC - SMSMobieleAPI

SMS-documentatie

SMSmobileAPI-ontwikkelaarsdocumentatie

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.

.

API-REST

cURL

Composer

Javascript-functie

Python

Node.js

Robijn

WSDL

SMS versturen

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

Eindpunt:

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

Parameters:

- apikey: Uw unieke API-sleutel.

- recipients: Het telefoonnummer van de ontvanger.

- message: 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)

- schedule_timestamp = Geeft de tijd weer vanaf wanneer de SMS verzonden moet worden - Moet een **UNIX-tijdstempel (GMT 0)** zijn

Voorbeeld:


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

Let op: Als er een bezorgfout optreedt die wordt veroorzaakt door uw provider, wordt standaard geprobeerd om hetzelfde sms-bericht maximaal 3 keer binnen een bepaald interval te verzenden.

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:

- guid: (verplicht) 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:

- apikey: (verplicht) Uw API-sleutel.

- guid_message: afgekort door de unieke identificatiecode voor het bericht dat 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` (`&error_api=1`) in om alle sms-berichten weer te geven waarbij een fout is opgetreden tijdens de API-aanvraag.

- error_mobile: Voer `1` (`&error_mobile=1`) in om een lijst te maken van alle sms-berichten 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:

- apikey: 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:

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

Webhook – SMS ontvangen

Dit webhooksysteem stuurt een POST-verzoek naar de geconfigureerde URL wanneer een SMS 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",

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

    "nummer": "+123456789",

    "gids": "abcde12345"

}

Payloadvelden:

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

Voorbeeld Webhook-eindpunt

Uw 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, waar);




// 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_responscode(200);

    echo "Webhook succesvol ontvangen.";

} anders {

    // Reageer met HTTP 400-status voor slechte verzoeken

    http_responscode(400);


    echo "Ongeldige payload.";

}

?>

De webhook testen

Om uw webhookconfiguratie te testen, kunt u hulpmiddelen gebruiken zoals:

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

Problemen oplossen

Zorg ervoor dat de webhook-URL correct en openbaar toegankelijk is.
Controleer of uw server een HTTP 200-statuscode retourneert voor succesvolle aanvragen.
Controleer de serverlogboeken op 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-sleutelverificatie

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.

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

SMS versturen

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

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


		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? Voel je vrij om een probleem te openen op GitHub! 🎯

Stuur SMS & WhatsApp

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.

Stuur SMS & WhatsApp

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.

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

U kunt WhatsApp-berichten alleen via onze API versturen. Klik hier om meer te weten te komen.

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

SMS-documentatie

SMS versturen

Niet-verzonden SMS opnieuw verzenden

LOG SMS verzonden

Ontvangen SMS

SMS verwijderen

SMS ontvangen - Webhook

Authenticatie

SMS versturen

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

Problemen oplossen

Authenticatie

1. API-sleutelverificatie

2. OAuth2-authenticatie

Een toegangstoken verkrijgen

Het toegangstoken gebruiken:

Welke methode moet u gebruiken?

SMS versturen

WSDL-URL

Parameters:

Voorbeeld

Stuur SMS & WhatsApp

Basis cURL-opdracht

cURL-voorbeeld in PHP

Stuur SMS & WhatsApp

De bibliotheek `aanvragen` 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

FAQ voor ontwikkelaars

Hoe genereer ik een API-sleutel?

Waar kan ik mijn API-sleutel altijd vinden?

Kan een API-sleutel anoniem worden aangemaakt?

Ga vandaag nog aan de slag met SMSmobileAPI!