Documentazione SMS
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.
Invia SMS
Questo endpoint ti consente di inviare un SMS dal tuo telefono cellulare.Punto finale:
Parametri:
| 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)
|
| shorturl |
1 = tutti gli URL nel messaggio verranno automaticamente convertiti in URL brevi 0 o vuoto = gli URL non verranno convertiti in URL brevi |
| sIdentifiant |
Se hai più telefoni collegati al tuo account, definisci quale telefono deve inviare l'SMS. Ogni telefono ha un identificativo univoco: utilizza questo identificativo per scegliere il dispositivo. Lascia vuoto questo campo per consentire al primo telefono disponibile di inviare l'SMS, oppure se hai un solo telefono collegato.
Per accedervi è necessaria la versione 3.0.35.3 o successiva dell'app. |
| 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=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld
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:
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:
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:
Parametro:
| Parametro | Descrizione |
|---|---|
| apikey | Necessario La chiave API che possiedi o che riceverai. |
| sIdentifiantPhone | Permette di isolare un numero di telefono collegato all'SMS ricevuto |
| after_timestamp_unix | Inserisci il "timestamp" Consente di elencare i messaggi SMS ricevuti dopo un determinato timestamp UNIX |
| onlyunread | Inserisci "Sì" Consente di elencare solo i messaggi SMS che non sono ancora stati contrassegnati come letti (in base allo stato dell'API). |
Esempio:
OTTIENI https://api.smsmobileapi.com/getsms/?apikey=LA_TUA_CHIAVE_API
Contrassegna i messaggi SMS ricevuti come letti
Questo endpoint API viene utilizzato per contrassegnare uno o più messaggi SMS ricevuti come letti solo nello stato API.
Ciò significa che lo stato di lettura viene aggiornato sul lato API, aiutandoti a filtrare i messaggi già elaborati quando utilizzi il filtro onlyunread=yes.
Importante:
Questa azione non influisce sullo stato di lettura sullo smartphone stesso: la modifica riguarda solo lo stato dell'API e non l'app di messaggistica o lo stato del sistema sul dispositivo.
Punto finale:
Parametro:
| Parametro | Descrizione |
|---|---|
| apikey | Necessario La chiave API che possiedi o che riceverai. |
| guid_message | Necessario GUID del messaggio da contrassegnare come letto |
Esempio:
OTTIENI https://api.smsmobileapi.com/getsms/set-read/?apikey=LA_TUA_CHIAVE_API&guid_message=GUID_MESSAGE
Elimina SMS
Questo endpoint API viene utilizzato per eliminare i messaggi SMS dal registro del server dell'API SMS Mobile
Punto finale:
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 sul dispositivo mobile stesso non verranno eliminati, poiché non abbiamo accesso ad essi.
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:
{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "Ciao, questo è un test.", "number": "+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:
Test del webhook
Per testare la configurazione del webhook, utilizza strumenti come:
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.
Ricevi chiamate perse
Questo endpoint API viene utilizzato per elencare le chiamate perse dal tuo cellulare tramite SMS Mobile API.
Punto finale:
Parametro:
| Parametro | Descrizione |
|---|---|
| apikey | Necessario La chiave API collegata al tuo cellulare. |
| offset | Posizione di inizio della paginazione (predefinita: 0). |
| limit | Numero massimo di risultati da restituire (predefinito: 100). |
| search | Cerca per numero o nome del contatto. |
| date_start | Filtra i risultati da questa data (formato: AAAA-MM-GG). |
| date_end | Filtra i risultati fino a questa data (formato: AAAA-MM-GG). |
Esempio:
OTTIENI https://api.smsmobileapi.com/missedcall/list/?apikey=LA_TUA_CHIAVE_API
Nota: per utilizzare questo endpoint, l'app SMS Mobile API deve essere installata sul tuo dispositivo mobile. La funzione "recupero chiamate perse" deve essere abilitata nell'app e devono essere concesse le autorizzazioni necessarie.
SMS arricchiti
ProssimamenteAutenticazione
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
Parametri:
- 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...
Utilizzando il richieste Biblioteca
IL richieste library è una libreria HTTP semplice e popolare per Python. Ecco come utilizzarla per inviare un SMS tramite 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)
Utilizzando il http.client Biblioteca
IL http.client la libreria è 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()
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
Utilizzando il andare a prendere API
IL andare a prendere L'API è un modo moderno e versatile per effettuare richieste HTTP in JavaScript. Ecco come puoi utilizzarla per inviare un SMS tramite 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));
Utilizzo XMLHttpRequest
Se hai bisogno di supportare browser più vecchi, puoi usare XMLHttpRequest oggetto:
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);
Invia SMS e WhatsApp
Utilizzando il assio Biblioteca
IL assio La libreria è un popolare client HTTP per Node.js. Ecco come utilizzarla per inviare un SMS tramite 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);
});
Invia SMS e WhatsApp
Utilizzando il Rete::HTTP Biblioteca
Puoi usare il Rete::HTTP libreria 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 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
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
English 
French 
German 
Spanish 
Portuguese 
Russian 
Finnish 
Japanese 
Chinese 
Vietnamese 
Dutch 
Greek 
Arabic 
Danish 
Italian 
Ukrainian