Documentazione API

1. Ottenere un token:

Descrizione: Dopo aver eseguito con successo questa interrogazione, riceverai un token. Successivamente, puoi usare questo token per accedere al server e fare richieste aggiuntive.
Endpoint https://smsgateway24.com/getdata/gettoken
Metodo:: GET

Parametri della richiesta:

Variabile	Tipo	Descrizione
email	string	[obbligatorio] Your login in the system. Usually email
pass	string	[obbligatorio] Your password in the system

Risposta formattata JSON::

Variabile	Tipo	Descrizione
token	string	Il token viene acquisito attraverso il metodo di recupero token:
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta:
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f41119fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

2. Invia SMS singolo utilizzando TOKEN:

Descrizione: Genera messaggi SMS sul server da inviare collettivamente in un singolo lotto. Abilita la creazione di messaggi SMS multipli contemporaneamente attraverso una singola richiesta.
Endpoint https://smsgateway24.com/getdata/addsms
Metodo:: GET, POST ( Usa %2B invece del segno plus '+' nella richiesta GET )

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.
sendto	string	[obbligatorio]Numero di telefono dell'abbonato. Tutti i caratteri sono ammissibili. Per esempio: +4915752982212, +4917642111111, +1 17642031984. In alternativa, è possibile specificare più numeri separati da virgole
body	string	[obbligatorio] Corpo del messaggio
device_id	string	[obbligatorio] Id Del Dispositivo
timetosend	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[opzionale] Tempo indicato per l'invio di un messaggio. Per esempio, 2025-10-22 07:41:42
sim	int, default = 0	[opzionale] SIM slot # 0 or 1
customerid	int	[opzionale] Numero ID del cliente. Campo opzionale.
urgent	int	[opzionale] SMS contrassegnato come urgente. Questo campo è opzionale. Gli SMS saranno inviati con priorità, e può essere utile quando si inviano password monouso (OTP).

Risposta formattata JSON::

Variabile	Tipo	Descrizione
token	string	Il token viene acquisito attraverso il metodo di recupero token:
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta:

  {
    "error": 0,
    "sms_id": 62807347,
    "message": "Sms has been saved successfully"}

2.1 Invia SMS singolo utilizzando login e password:

Descrizione: Genera messaggi SMS sul server da inviare collettivamente in un singolo lotto. Abilita la creazione di messaggi SMS multipli contemporaneamente attraverso una singola richiesta.
Endpoint https://smsgateway24.com/getdata/smstosend
Metodo:: GET, POST ( Usa %2B invece del segno plus '+' nella richiesta GET )

Parametri della richiesta:

Variabile	Tipo	Descrizione
email	string	[obbligatorio] La tua email
pass	string	[obbligatorio] La tua password
sendto	string	[obbligatorio]Numero di telefono dell'abbonato. Tutti i caratteri sono ammissibili. Per esempio: +4915752982212, +4917642111111, +1 17642031984. In alternativa, è possibile specificare più numeri separati da virgole
body	string	[obbligatorio] Corpo del messaggio
device_id	string	[obbligatorio] Id Del Dispositivo
timetosend	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[opzionale] Tempo indicato per l'invio di un messaggio. Per esempio, 2025-10-22 07:41:42
sim	int, default = 0	[opzionale] SIM slot # 0 or 1
customerid	int	[opzionale] Numero ID del cliente. Campo opzionale.
urgent	int	[opzionale] SMS contrassegnato come urgente. Questo campo è opzionale. Gli SMS saranno inviati con priorità, e può essere utile quando si inviano password monouso (OTP).

Risposta formattata JSON::

Variabile	Tipo	Descrizione
token	string	Il token viene acquisito attraverso il metodo di recupero token:
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta:

  {
    "error": 0,
    "sms_id": 62807347,
    "message": "Sms has been saved successfully"}

3. Invio di SMS in massa utilizzando JSON

Descrizione: Crea SMS sul server da inviare. Dopo di che, il telefono con l'applicazione Smsgateway24 chiama il server e prende l'SMS e lo invia dalla scheda SIM Scarica l'applicazione al link
Endpoint https://smsgateway24.com/getdata/addalotofsms
Metodo:: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
datajson	string	[obbligatorio] {"token":"df427bfcf113c9a21c67718035076b5b","smsdata":[{"sendto":"015752982212","body":"Test message","sim":1,"timetosend":"2019-07-01 23:50:00","device_id":260},{"sendto":"+4915752982212","body":"Test message 2","sim":1,"timetosend":"2019-07-01 23:50:00","device_id":260,"urgent":1}]}

Risposta formattata JSON::

Variabile	Tipo	Descrizione
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Request example:

{
   "token":"df427bfcf113c9a21c6771803501",
   "smsdata":[
        {
            "sendto":"015752982212",
            "body":"Your password is 12345",
            "sim":1,
            "timetosend":"2019-07-01 23:50:00",
            "device_id":260,
            "customerid":122,
            "urgent":1
        },
        {
            "sendto":"015752982212",
            "body":"Regular SMS. Not urgnet",
            "sim":1,
            "timetosend":"2019-07-01 23:50:00",
            "device_id":260,
            "customerid":122,
            "urgent":0
        }
    ]
}

4. Ottieni tutti gli SMS (inclusi gli SMS in entrata):

Descrizione: Questa richiesta consente di recuperare tutti i messaggi associati al tuo account, inclusi gli SMS in arrivo dai clienti. Tutte le variabili di input sono obbligatorie in questo metodo e i messaggi SMS possono variare di stato.
Endpoint: https://smsgateway24.com/getdata/getallsms
Metodo: GET, POST (Utilizzare %2B invece del segno più "+" nella richiesta GET)

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.
device_id	string	[opzionale] Id Del Dispositivo
status	int	[opzionale] 1 - SMS In Attesa 2 - SMS presi per telefono 3 - In coda per l'invio. Certainly, it would have been more logical to place the status "queued for sending" before "SMS taken by phone," but for backward compatibility, the statuses are in the following order: 1, 3, 2." 5 - Sms In Arrivo 6 - SMS inviati per telefono 7 - Gli SMS sono stati spediti 8 - SMS NON consegnato 9 - SMS non SENT affatto - Errore generico. (Leggi cosa fare con questo errore qui) Altri errori meno comuni: 10 - SMS Non Inviato - No Service 11 - SMS Non Inviato - Null PDU 12 - SMS Non Inviato - Radio Off 100, 101 - SMS Non Inviato - NOT ALLOWED. (Non sono state concesse autorizzazioni per l'invio di SMS nell'applicazione)
begindate	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[opzionale] Begin Date Time
enddate	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[opzionale] End Date Time
sim	int	[opzionale] SIM slot # 0 or 1
customerid	int	[opzionale] Numero ID del cliente. Campo opzionale
onlycount	int	[opzionale] 0 \| 1 conteggio solo
phone	string	[opzionale] 0 \| 1 Filtro numero di telefono
orderbydesc	int	[opzionale] 0 \| 1 Order by any field
timezone	int	[opzionale] Specifica il tuo fuso orario locale, ad esempio impostandolo in Australia/Sydney.

Risposta formattata JSON::

Variabile	Tipo	Descrizione
token	string	Il token viene acquisito attraverso il metodo di recupero token:
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine
count	int	SMS amount
smss	int	JSON object

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta ... :


            {
    "smss": {
        "62050971": {
            "id": 62050971,
            "sendto": "+4912312312332",
            "body": "Hello! Thank you for Order! ",
            "customerid": null,
            "status": 2,
            "statustitle": "sending",
            "deviceid": 11231,
            "urgent": null,
            "created": {
                "date": "2023-11-02 22:44:43.000000",
                "timezone_type": 3,
                "timezone": "Europe/Paris"
            },
            "senttime": null,
            "timetosend": null,
            "paketid": null,
            "pakettitle": null,
            "paketbody": null
        },
        "62051117": {
            "id": 62051117,
            "sendto": "+4912312312332",
            "body": "Hello! Thank you for Order! ",
            "customerid": null,
            "status": 7,
            "statustitle": "delivered",
            "deviceid": 11231,
            "urgent": null,
            "created": {
                "date": "2023-11-02 22:46:09.000000",
                "timezone_type": 3,
                "timezone": "Europe/Paris"
            },
            "senttime": null,
            "timetosend": null,
            "paketid": null,
            "pakettitle": null,
            "paketbody": null
        }
            }
            }

5. Aggiungi un nuovo elenco contatti

Descrizione: Il tag è necessario per generare una newsletter mirata a un gruppo di numeri. Per esempio, usa il tag Dipendenti
Endpoint https://smsgateway24.com/getdata/savetag
Metodo:: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.
title	string	[obbligatorio] Nome etichetta

Risposta formattata JSON::

Variabile	Tipo	Descrizione
tag_id	int	Tag ID
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta:

{
    "error": 0,
    "tag_id": 8303,
    "message": "OK"
}

6. Aggiungi contatti all'elenco contatti:

Descrizione: Aggiungi contatti per qualsiasi tag. Ad esempio, per il tag * Dipendenti * i tuoi colleghi saranno perfettamente in forma.
Endpoint https://smsgateway24.com/getdata/savecontact
Metodo:: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.
phone	string	[obbligatorio] phone number
ctag_id	int	[obbligatorio] Tag ID
fullname	string	[obbligatorio] Nome del tuo cliente

Risposta formattata JSON::

Variabile	Tipo	Descrizione
contact_id	int	Contact Id
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta ... :
{"error":0,"contact_id":15954765,"message":"ok"}

7. Crea una newsletter

Descrizione:Una volta che hai creato il tag, puoi fare la mail sui telefoni tag.
Endpoint https://smsgateway24.com/getdata/savepaket
Metodo:: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.
title	string	[obbligatorio] Titolo della newsletter
device_id	string	[obbligatorio] Id Del Dispositivo
body	string	[obbligatorio] Corpo messaggio obiettivo
tags	string	[obbligatorio] Tag Id. Può essere diverso, separato da virgole. Per esempio: 12,13,14
sim	int, default = 0	[obbligatorio]numero di slot sim nel telefono: 0 or 1
time_to_send	int, default = 0	[obbligatorio]Date time when Newsletter should be sent. Do not forget tap start on device. DD.MM.YYYY H:i:s

Risposta formattata JSON::

Variabile	Tipo	Descrizione
contact_id	int	Id Contatto
error	int	0 <unk> 1 - indica se c'è un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.
paket_id	int	Package ID

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta ... :
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f4f49fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

8. Ottieni elenco dispositivi

Descrizione: Puoi scoprire tutto sui tuoi dispositivi.
Endpoint https://smsgateway24.com/getdata/getalldevices
Metodo:: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.

Risposta formattata JSON::

Variabile	Tipo	Descrizione
count	int	Numero di dispositivi:
device	json	id - Id Del Dispositivo title - Nome Del Dispositivo created - Data Creazione Dispositivo createdhumanformat - Dispositivo creato data in formato regolare lastseen - La data in cui il dispositivo è stato visto l'ultima volta lastseenhumanformat - La data in cui il dispositivo è stato visto l'ultima volta serialnumber - Numero di serie del dispositivo siminfo - Informazioni sulle schede SIM in JSON appversion - La versione dell'applicazione installata sul dispositivo subscription - C'è un abbonamento sul dispositivo
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta:

    {
    "count": 2,
    "device": {
        "1576": {
            "id": 1576,
            "title": "AOSP_on_IA_Emulator",
            "number": null,
            "imei": "358240051111110",
            "created": {
                "date": "2020-03-28 20:10:29.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "createdhumanformat": "28.03.2020 20:10:29",
            "lastseen": {
                "date": "2020-04-23 17:02:21.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "lastseenhumanformat": "23.04.2020 17:02:21",
            "serialnumber": "EMULATOR30X0X5X0",
            "siminfo": [
                {
                    "Slot": "0",
                    "IccId": "89014103211118510720",
                    "Number": " 15555215554",
                    "Roaming": "0",
                    "CountryIso": "us",
                    "CarrierName": "Android (T-Mobile)"
                }
            ],
            "appversion": "12.1.21",
            "isappversionactual": false,
            "delaybetweeneachsms": null,
            "delaybetweenrequest": 1,
            "subscription": true
        },
        "1297": {
            "id": 1297,
            "title": "Android_SDK_built_for_x86",
            "number": null,
            "imei": "null",
            "created": {
                "date": "2020-01-20 14:01:05.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "createdhumanformat": "20.01.2020 14:01:05",
            "lastseen": {
                "date": "2020-04-20 20:51:34.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "lastseenhumanformat": "20.04.2020 20:51:34",
            "serialnumber": "unknown",
            "siminfo": [
                {
                    "Slot": "0",
                    "IccId": "8949226172233934327",
                    "Number": "+4915752982212",
                    "Roaming": "1",
                    "CountryIso": "de",
                    "CarrierName": "Drillisch (o2)"
                }
            ],
            "appversion": "12.1.21",
            "isappversionactual": false,
            "delaybetweeneachsms": 5,
            "delaybetweenrequest": 10,
            "subscription": false
        }
    }
}

9. Ottieni lo stato di consegna di un singolo SMS

Descrizione: Puoi trovare lo stato di consegna di ogni SMS con questo metodo
Endpoint https://smsgateway24.com/getdata/getsmsstatus
Metodo:: GET, POST

Parametri della richiesta:

Variabile	Tipo	Descrizione
token	string	[obbligatorio] Il token viene acquisito attraverso il metodo di recupero del token.
sms_id	int	[obbligatorio] Sms Id

Risposta formattata JSON::

Variabile	Tipo	Descrizione
sms_id	int	SMS ID
status	int	SMS Status 1 - SMS In Attesa 2 - SMS presi per telefono 3 - In coda per l'invio. Certainly, it would have been more logical to place the status "queued for sending" before "SMS taken by phone," but for backward compatibility, the statuses are in the following order: 1, 3, 2." 5 - Sms In Arrivo 6 - SMS inviati per telefono 7 - Gli SMS sono stati spediti 8 - SMS NON consegnato 9 - SMS non SENT affatto - Errore generico. (Leggi cosa fare con questo errore qui) Altri errori meno comuni: 10 - SMS Non Inviato - No Service 11 - SMS Non Inviato - Null PDU 12 - SMS Non Inviato - Radio Off 100, 101 - SMS Non Inviato - NOT ALLOWED. (Non sono state concesse autorizzazioni per l'invio di SMS nell'applicazione)
status_description	string	Nome Stato
error	int	0 \| 1 - si è verificato un errore nell'elaborazione della richiesta
message	string	Messaggio di errore, vuoto se tutto è in ordine.

Link all'esempio di codice Curl
Link all'esempio di codice Guzzle
Esempio di risposta:
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f4f49fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

Accesso rapido

Riferimento API

__SDK e altre libs

Plugin

Documentazione | SmsGateway24.com

1. Ottenere un token:

2. Invia SMS singolo utilizzando TOKEN:

2.1 Invia SMS singolo utilizzando login e password:

3. Invio di SMS in massa utilizzando JSON

4. Ottieni tutti gli SMS (inclusi gli SMS in entrata):

5. Aggiungi un nuovo elenco contatti

6. Aggiungi contatti all'elenco contatti:

7. Crea una newsletter

8. Ottieni elenco dispositivi

9. Ottieni lo stato di consegna di un singolo SMS

Accesso rapido

Documentazione api

Riferimento API

__SDK e altre libs

Plugin

Documentazione | SmsGateway24.com

1. Ottenere un token:

2. Invia SMS singolo utilizzando TOKEN:

2.1 Invia SMS singolo utilizzando login e password:

3. Invio di SMS in massa utilizzando JSON

4. Ottieni tutti gli SMS (inclusi gli SMS in entrata):

5. Aggiungi un nuovo elenco contatti

6. Aggiungi contatti all'elenco contatti:

7. Crea una newsletter

8. Ottieni elenco dispositivi

9. Ottieni lo stato di consegna di un singolo SMS