Documentazione api

Documentazione | SmsGateway24.com

v.1.0

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, 2024-04-25 08:49:00
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, 2024-04-25 08:49:00
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"}