Dev DOC - SMSMobileAPI

Documentazione SMS

Documentazione per sviluppatori SMSmobileAPI

Noi di SMSmobileAPI ci impegniamo a rendere la nostra API il più compatibile possibile con qualsiasi architettura o piattaforma.
Che tu utilizzi REST, SOAP, cURL o vari linguaggi di programmazione come Python, JavaScript, PHP e altri, la nostra API è progettata per integrarsi perfettamente nei tuoi progetti.

Disponiamo anche di plugin pronti all'uso per soluzioni e software di e-commerce. Clicca qui per scoprirli.

.

API REST

cURL

Composer

JavaScript

Pitone

Node.js

Rubino

WSDL

Invia SMS

Questo endpoint ti consente di inviare un SMS dal tuo telefono cellulare.

Punto finale:

OTTENERE INVIARE https://api.smsmobileapi.com/sendsms/

Parametri:

Parametro	Parametro	Descrizione
apikey	Necessario La tua chiave API univoca.
recipients	Necessario Il numero di telefono del destinatario.
message	Necessario Il messaggio da inviare (la lunghezza del messaggio non è limitata a 160 caratteri; è possibile inviare messaggi più lunghi)
sendwa	1 = il messaggio deve essere inviato tramite WhatsApp.
sendsms	1 = il messaggio deve essere inviato tramite SMS tradizionale. (Se invia SMS è vuoto: inviato di default, impostare su 0 per bloccare gli SMS)
encrypt_message	SÌ = Il messaggio verrà crittografato quando verrà letto dal destinatario. Per decifrare il messaggio, il destinatario dovrà immettere una chiave univoca. Scopri di più sulla crittografia dei messaggi
schedule_timestamp	Rappresenta l'ora da cui deve essere inviato l'SMS - Deve essere un Timestamp UNIX (GMT 0)

Esempio:


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

Nota: in caso di errore di recapito causato dal tuo operatore, una funzione predefinita riprova a inviare lo stesso SMS fino a 3 volte entro un intervallo definito.

Reinvia un SMS non inviato

Questo endpoint API viene utilizzato per reinviare un SMS non inviato (solo se il messaggio presenta uno stato di errore)

Punto finale:

OTTENERE INVIARE https://api.smsmobileapi.com/resend/

Parametro:

Parametro	Descrizione
guid	Necessario GUID del messaggio da reinviare.

Esempio:


        OTTIENI https://api.smsmobileapi.com/resend/?apikey=LA_TUA_CHIAVE_API&guid=GUID_DEL_MESSAGGIO

Registro degli SMS inviati dall'API

Questo endpoint API viene utilizzato per recuperare il registro dei messaggi SMS inviati tramite l'API.

Punto finale:

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

Parametro:

Parametro	Descrizione
apikey	Necessario La tua chiave API.
guid_message	Abbreviato dall'identificatore univoco del messaggio utilizzato per l'ordinamento e il filtraggio.
before	Recupera i messaggi inviati prima di questo specifico timestamp o GUID.
error_api	Inserisci 1 per elencare tutti gli SMS che hanno riscontrato un errore durante la richiesta API.
error_mobile	Inserisci 1 per elencare tutti gli SMS che hanno riscontrato un errore durante l'elaborazione mobile.
keyword	Parola chiave per filtrare i messaggi in base al numero del destinatario o al contenuto dell'SMS.

Esempio:


        OTTIENI https://api.smsmobileapi.com/log/sent/sms?apikey=LA_TUA_CHIAVE_API

SMS ricevuto

Questo endpoint API viene utilizzato per recuperare i messaggi SMS ricevuti sullo smartphone.

Punto finale:

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

Parametro:

Parametro	Descrizione
apikey	Necessario La chiave API che possiedi o che riceverai.

Esempio:


        OTTIENI https://api.smsmobileapi.com/getsms/?apikey=LA_TUA_CHIAVE_API

Elimina SMS

Questo endpoint API viene utilizzato per eliminare i messaggi SMS dal registro del server dell'API SMS Mobile

Punto finale:

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

Parametro:

Parametro	Descrizione
apikey	Necessario La chiave API in tuo possesso.
guid_message	ID univoco del messaggio da eliminare.
date_start	Se utilizzato da solo, elimina tutti i messaggi del giorno specificato.
date_start and date_end	Combinato per eliminare i messaggi entro un periodo di tempo specificato.

Esempio:


        OTTIENI https://api.smsmobileapi.com/deletesms/?apikey=LA_TUA_CHIAVE_API

Nota: gli SMS eliminati sono solo quelli memorizzati nei registri del tuo account dell'app mobile. Gli SMS presenti sul dispositivo mobile non verranno eliminati, poiché non vi abbiamo accesso.

Webhook – SMS ricevuto

Questo sistema webhook invia una richiesta POST all'URL configurato ogni volta che riceve un SMS. Il sistema garantisce aggiornamenti in tempo reale inviando i dettagli dell'SMS all'URL webhook specificato.

Come configurare il webhook nella dashboard

Per impostare l'URL del webhook nella dashboard, segui questi passaggi:

Accedi al tuo account su Dashboard API mobile SMS.
Vai a Impostazioni webhook sezione.
Inserisci l'URL del tuo webhook (ad esempio, https://example.com/webhook-endpoint
Fare clic su Salva Webhook pulsante.
Una volta salvato, il sistema inizierà a inviare i dettagli SMS all'URL configurato.

Payload del webhook

Quando viene ricevuto un SMS, il sistema invia il seguente payload JSON all'URL del webhook:

{

    "data": "2025-01-20",

    "ora": "10:15:00",

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

    "messaggio": "Ciao, questo è un test.",

    "numero": "+123456789",

    "guid": "abcde12345"

}

Campi del carico utile:

data: Data in cui è stato aggiunto l'SMS (AAAA-MM-GG).
ora: Ora in cui è stato aggiunto l'SMS (HH:mm:ss).
tempo_ricevuto: Ora in cui è stato ricevuto l'SMS.
messaggio: Contenuto dell'SMS.
numero: Numero di telefono del mittente.
guida: Identificatore univoco dell'SMS.

Esempio di endpoint webhook

Il tuo server dovrebbe essere pronto a gestire le richieste POST in arrivo. Di seguito è riportato uno script PHP di esempio per elaborare il payload del webhook:

<?php

// Leggi il payload in arrivo

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

$data = json_decode($payload, true);




// Elaborare i dati SMS

se ($data) {

    // Esempio: registra i dati degli SMS in un file

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




    // Rispondi con lo stato HTTP 200

    http_response_code(200);

    echo "Webhook ricevuto correttamente.";

} altro {

    // Rispondi con lo stato HTTP 400 per le richieste non valide

    http_response_code(400);


    echo "Carico utile non valido.";

}

?>

Test del webhook

Per testare la configurazione del webhook, utilizza strumenti come:

Questi strumenti consentono di ispezionare il payload inviato dal sistema e di risolvere eventuali problemi relativi alla configurazione del webhook.

Risoluzione dei problemi

Assicurarsi che l'URL del webhook sia corretto e accessibile al pubblico.
Verifica che il tuo server restituisca un codice di stato HTTP 200 per le richieste andate a buon fine.
Controlla i log del server per eventuali errori nell'elaborazione del payload.

Autenticazione

L'API SMSMobile supporta due metodi di autenticazione: tramite una semplice chiave API o tramite il protocollo OAuth2 con un ID client e un segreto client.

1. Autenticazione tramite chiave API

Questo metodo richiede una chiave API che può essere inclusa come parametro in una richiesta GET o POST. È un modo semplice per autenticare le richieste API.

2. Autenticazione OAuth2

OAuth2 fornisce un metodo di autenticazione più sicuro e scalabile.
Sarà necessario utilizzare un ID client e un segreto client per ottenere un token di accesso, che dovrebbe quindi essere incluso nelle richieste API utilizzando Autorizzazione intestazione.

I parametri client_id e client_secret sono disponibili nella dashboard, accessibili dopo aver installato l'app e creato un account sul tuo dispositivo mobile.
Scarica subito l'app mobile O accedi alla tua dashboard.

Ottenere un token di accesso

Per ottenere un token di accesso, invia una richiesta POST all'endpoint del token con il tuo ID client e il tuo segreto client.


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"

Utilizzo del token di accesso:

Una volta ottenuto il token di accesso, includilo nel Autorizzazione intestazione delle tue richieste API:


curl -X POST https://api.smsmobileapi.com/sendsms \

-H "Autorizzazione: Portatore abc123xyz456" \

-H "Tipo di contenuto: application/x-www-form-urlencoded" \

-d "destinatari=+1234567890" \

-d "messaggio=Ciao"

Quale metodo dovresti usare?

- Utilizzo Autenticazione tramite chiave API per integrazioni rapide e semplici.

- Utilizzo Autenticazione OAuth2 per una maggiore sicurezza e scalabilità nelle tue integrazioni.

Per maggiori dettagli, fare riferimento alla documentazione completa.

Invia SMS

URL WSDL

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

Parametri:

- recipients: Il numero di cellulare del destinatario.

- message: Il messaggio da inviare. (La lunghezza del messaggio non è limitata a 160 caratteri; è possibile inviare messaggi più lunghi)

- apikey: La chiave API che possiedi o che riceverai.

Esempio


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

Invia SMS e WhatsApp

Comando cURL di base

È possibile utilizzare il seguente comando cURL per inviare un SMS tramite 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"

Esempio di cURL in PHP

Se utilizzi PHP, ecco come puoi inviare un SMS utilizzando 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;

        

        ?>

Questo esempio PHP mostra come inviare una richiesta POST tramite cURL alla SMSmobileAPI, passando i parametri necessari come array associativo.

Invia SMS e WhatsApp

Utilizza il nostro modulo Python ufficiale: https://smsmobileapi.com/python/
oppure usa il metodo manuale...

Utilizzo della libreria `requests`

La libreria `requests` è una libreria HTTP semplice e diffusa per Python. Ecco come usarla per inviare un SMS tramite l'API SMSmobile:


        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)

Questo esempio mostra una semplice richiesta POST all'API SMSmobile, che invia un messaggio a uno specifico numero di telefono.

Utilizzo della libreria `http.client`

La libreria `http.client` è inclusa nella libreria standard di Python e può essere utilizzata anche per interagire con la tua 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()

Questo esempio mostra come utilizzare la libreria `http.client` per inviare una richiesta POST all'API. I parametri sono codificati in URL e inviati con le intestazioni appropriate.

API SMS Mobile - SDK PHP (Composer)

L'SMS Mobile API PHP SDK è disponibile tramite Composer, semplificando l'integrazione dell'invio di SMS nelle applicazioni PHP.


		il compositore richiede smsmobileapi/sdk

Per documentazione dettagliata, istruzioni di installazione ed esempi di utilizzo, visita il nostro repository GitHub:

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

Su GitHub troverai:
✔️ Guida completa all'installazione
✔️ Esempio di utilizzo
✔️ Riferimenti API e best practice

Hai bisogno di aiuto? Sentiti libero di aprire una segnalazione su GitHub! 🎯

Invia SMS e WhatsApp

Utilizzo dell'API `fetch`

L'API `fetch` è un modo moderno e versatile per effettuare richieste HTTP in JavaScript. Ecco come utilizzarla per inviare un SMS tramite l'API SMSmobile:


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

Questo esempio mostra come inviare una richiesta POST utilizzando l'API `fetch`, supportata dalla maggior parte dei browser moderni.

Utilizzo di `XMLHttpRequest`

Se hai bisogno di supportare browser più vecchi, puoi utilizzare l'oggetto `XMLHttpRequest`:


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

Questo esempio mostra come utilizzare `XMLHttpRequest` per inviare una richiesta POST, garantendo la compatibilità con i browser più vecchi che potrebbero non supportare `fetch`.

Invia SMS e WhatsApp

Utilizzo della libreria `axios`

La libreria `axios` è un popolare client HTTP per Node.js. Ecco come utilizzarla per inviare un SMS tramite la 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);

        });

Questo esempio mostra come inviare una richiesta POST utilizzando `axios` in Node.js per interagire con SMSmobileAPI.

Invia SMS e WhatsApp

Utilizzo della libreria `Net::HTTP`

È possibile utilizzare la libreria `Net::HTTP` in Ruby per inviare un SMS tramite 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

Questo esempio mostra come inviare una richiesta POST utilizzando `Net::HTTP` in Ruby a SMSmobileAPI.

Puoi inviare messaggi WhatsApp solo tramite la nostra API. Clicca qui per saperne di più.

Se hai domande, suggerimenti o hai bisogno di assistenza, il nostro team è qui per aiutarti.
Non esitate a contattarci a api@smsmobileapi.com

Fai clic qui per testare la chiave API e il servizio con il semplice modulo

A seconda della versione di Android installata sul telefono cellulare, il sistema operativo potrebbe ostacolare il corretto funzionamento dell'invio e della ricezione automatica di messaggi SMS quando l'applicazione SmsMobileApi non è in primo piano.
Questo problema deriva da un processo che tenta di essere eseguito in background quando l'applicazione non è in esecuzione. Tuttavia, a causa delle misure di ottimizzazione della batteria di Android, che variano a seconda della versione, questo processo in background potrebbe non avviarsi correttamente. L'ottimizzazione della batteria di Android è progettata per limitare l'attività in background delle app al fine di preservarne la durata, il che può influire inavvertitamente sulle app che richiedono processi in background per funzionare correttamente.

Per risolvere questo problema, gli utenti possono configurare manualmente le impostazioni Android per consentire a SmsMobileApi di utilizzare le risorse senza restrizioni.
Ciò comporta la regolazione delle impostazioni di ottimizzazione della batteria per l'app specifica, in sostanza, indicando ad Android che l'SmsMobileApi può essere eseguita in background e utilizzare le risorse in base alle esigenze. In questo modo, l'applicazione dovrebbe essere in grado di inviare e ricevere automaticamente messaggi SMS anche quando non è l'applicazione attiva in primo piano. Questa regolazione garantisce che il processo in background necessario possa funzionare senza interruzioni, aggirando le funzionalità di ottimizzazione della batteria che altrimenti potrebbero impedirne la corretta esecuzione.

FAQ per sviluppatori

Come generare una chiave API?

Descrizione di esempio a fisarmonica: per generare una chiave API, scarica la nostra applicazione sul tuo cellulare e crea un account gratuitamente. Una chiave API verrà generata automaticamente e associata al tuo cellulare. Riceverai anche un'e-mail con tutte le informazioni necessarie. Questo processo ti consente di iniziare a utilizzare i nostri servizi in modo rapido e semplice, con una configurazione minima.

Dove posso trovare la mia chiave API?

Nella tua applicazione mobile, accedi al menu IMPOSTAZIONI o AIUTO, dove la tua chiave API è sempre visibile. In questo modo potrai accedere facilmente alla tua chiave API ogni volta che ne hai bisogno per integrare o utilizzare i nostri servizi.

La creazione di una chiave API può essere anonima?

Sì, non richiediamo alcuna prova di identità per la creazione di una chiave API. La comunicazione tra la nostra API e il tuo telefono cellulare è quindi anonima al 100%. Questo approccio consente agli utenti di preservare la propria privacy durante l'utilizzo dei nostri servizi.

Inizia subito a usare SMSmobileAPI!

Scopri la libertà e la flessibilità di gestire i tuoi servizi SMS ovunque ti trovi. Scarica subito la nostra app mobile e fai il primo passo verso un'integrazione SMS perfetta.

Scarica l'app

Funzionalità SMS

Funzionalità di WhatsApp

Plugin generali

Plugin per negozi online

API e documentazione per sviluppatori

Registro strumenti e modifiche

Documentazione SMS

Invia SMS

Reinvia SMS non inviati

LOG SMS inviato

Ricevi SMS ricevuti

Elimina SMS

SMS ricevuto - Webhook

Autenticazione

Invia SMS

Punto finale:

Parametri:

Esempio:

Reinvia un SMS non inviato

Punto finale:

Parametro:

Esempio:

Registro degli SMS inviati dall'API

Punto finale:

Parametro:

Esempio:

SMS ricevuto

Punto finale:

Parametro:

Esempio:

Elimina SMS

Punto finale:

Parametro:

Esempio:

Webhook – SMS ricevuto

Come configurare il webhook nella dashboard

Payload del webhook

Campi del carico utile:

Esempio di endpoint webhook

Test del webhook

Risoluzione dei problemi

Autenticazione

1. Autenticazione tramite chiave API

2. Autenticazione OAuth2

Ottenere un token di accesso

Utilizzo del token di accesso:

Quale metodo dovresti usare?

Invia SMS

URL WSDL

Parametri:

Esempio

Invia SMS e WhatsApp

Comando cURL di base

Esempio di cURL in PHP

Invia SMS e WhatsApp

Utilizzo della libreria `requests`

Utilizzo della libreria `http.client`

API SMS Mobile - SDK PHP (Composer)

Invia SMS e WhatsApp

Utilizzo dell'API `fetch`

Utilizzo di `XMLHttpRequest`

Invia SMS e WhatsApp

Utilizzo della libreria `axios`

Invia SMS e WhatsApp

Utilizzo della libreria `Net::HTTP`

FAQ per sviluppatori

Come generare una chiave API?

Dove posso trovare la mia chiave API?

La creazione di una chiave API può essere anonima?

Inizia subito a usare SMSmobileAPI!