Документация по API

1. Получение токена:

Пояснение: После успешного выполнения этого запроса вы получите токен. Затем вы можете использовать этот токен для доступа к серверу и выполнения дополнительных запросов.
Конечная точка: https://smsgateway24.com/getdata/gettoken
Метод:: GET

Параметры запроса:

Переменная	Тип	Описание
email	string	[обязательный] Your login in the system. Usually email
pass	string	[обязательный] Your password in the system

Ответ в формате JSON::

Переменная	Тип	Описание
token	string	Ваш токен получен с помощью метода извлечения токена:
error	int	0 \| 1 - указывает, есть ли ошибка при обработке запроса
message	string	Сообщение об ошибке, пустое, если все в порядке.

Ссылка на пример кода Curl
Ссылка на пример кода Guzzle
Пример ответа:
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f41119fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

2. Send single message using TOKEN:

Пояснение: Creates one outgoing message on the server. The message can be sent through the selected channel of your connected Android device.
Конечная точка: https://smsgateway24.com/getdata/addsms
Метод: GET, POST (Использовать %2B вместо знака плюса «+» в запросе GET)

Параметры запроса:

Переменная	Тип	Описание
token	string	[обязательный] Ваш токен получен с помощью метода извлечения токена.
sendto	string	[обязательный] Recipient address or phone number. Multiple values can be separated by commas.
body	string	[обязательный] Тело сообщения
device_id	int	[обязательный] ID устройства
channel_id	int	[опционально] Channel identifier on the device. If omitted, the default device channel is used.
timetosend	string YYYY-MM-DD или YYYY-MM-DD HH:MM:SS	[опционально] Время, определенное для отправки сообщения. Например 2026-03-28 23:26:50
customerid	int	[опционально] ID покупателя необязательное поле
urgent	int	[опционально] Marks the message as urgent. Useful for OTP and high-priority traffic.

Ответ в формате JSON:

Переменная	Тип	Описание
error	int	0 or 1 - indicates whether there is an error in processing the request
message	string	Сообщение об ошибке, пустое, если все в порядке.
sms_id	int	Created message identifier in our system.

Ссылка на пример кода Curl
Ссылка на пример кода Guzzle Пример ответа:

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

2.1 Legacy method: send single SMS using login and password

Deprecated. Use token-based authentication for new integrations. This method is kept only for backward compatibility.

Конечная точка: https://smsgateway24.com/getdata/smstosend
Метод: GET, POST

Параметры запроса:

Переменная	Тип	Описание
email	string	[обязательный] Ваш email
pass	string	[обязательный] Ваш пароль
sendto	string	[обязательный] Recipient address or phone number.
body	string	[обязательный] Тело сообщения
device_id	int	[обязательный] ID устройства
channel_id	int	[опционально] Channel identifier on the device.
timetosend	string	[опционально] Scheduled sending time.
customerid	int	[опционально] Your customer identifier.
urgent	int	[опционально] Marks the message as urgent.

3. Массовая отправка SMS с использованием JSON

Пояснение: Создает SMS на сервере для отправки. После этого Телефон с приложением Smsgateway24 звонит серверу и принимает SMS и отправляет его с SIM-карты Скачать приложение по ссылке
Конечная точка: https://smsgateway24.com/getdata/addalotofsms
Метод:: GET, POST

Параметры запроса:

Переменная	Тип	Описание
datajson	string	[обязательный] {"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}]}

Ответ в формате JSON::

Переменная	Тип	Описание
error	int	0 \| 1 - указывает, есть ли ошибка при обработке запроса
message	string	Сообщение об ошибке, пустое, если все в порядке.

Ссылка на пример кода Curl
Ссылка на пример кода 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. Получить все SMS (включая входящие SMS):

Описание: Этот запрос позволяет вам получать все сообщения, связанные с вашей учетной записью, включая входящие SMS от клиентов. Все входные переменные являются обязательными для этого метода, и статус SMS-сообщений может варьироваться.
Endpoint: https://smsgateway24.com/getdata/getallsms
Метод: GET, POST (Используйте %2B вместо знака "+" в запросе GET)

Параметры запроса:

Переменная	Тип	Описание
token	string	[обязательный] Ваш токен получен с помощью метода извлечения токена.
device_id	string	[опционально] ID устройства
status	int	[опционально] 1 - Ожидание СМС 2 - SMS, принятые по телефону 3 - В очереди для отправки. 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 6 - Отправленное SMS по телефону 7 - SMS доставлено 8 - SMS не было доставлено 9 - SMS не отправлено вовсе - обобщенный сбой. (Читайте что делать с этой ошибкой здесь) Другое, меньше распространенных ошибок: 10 - SMS не отправлено - No Service 11 - SMS не отправлено - Null PDU 12 - SMS не отправлено - Radio Off 100, 101 - SMS не отправлено - NOT ALLOWED. (Разрешения для отправки SMS в приложении не были предоставлены)
begindate	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[опционально] Begin Date Time
enddate	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[опционально] End Date Time
sim	int	[опционально] SIM slot # 0 or 1
customerid	int	[опционально] ID покупателя необязательное поле
onlycount	int	[опционально] 0 \| 1 только подсчет
phone	string	[опционально] 0 \| 1 Фильтр номера телефона
orderbydesc	int	[опционально] 0 \| 1 Order by any field
timezone	int	[опционально] Укажите свой местный часовой пояс, например установить его в Австралию/Сиднее.

Ответ в формате JSON::

Переменная	Тип	Описание
token	string	Ваш токен получен с помощью метода извлечения токена:
error	int	0 \| 1 - указывает, есть ли ошибка при обработке запроса
message	string	Сообщение об ошибке, пусто, если все в порядке
count	int	SMS amount
smss	int	JSON object

Ссылка на пример кода Curl
Ссылка на пример кода Guzzle
Пример ответа ... :


            {
    "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. Добавить новый список контактов

Пояснение: Тег необходим для создания бюллетеня, ориентированного на группу чисел. Например, для сотрудников тегов
Конечная точка: https://smsgateway24.com/getdata/savetag
Метод:: GET, POST

Параметры запроса:

Переменная	Тип	Описание
token	string	[обязательный] Ваш токен получен с помощью метода извлечения токена.
title	string	[обязательный] Имя тега

Ответ в формате JSON::

Переменная	Тип	Описание
tag_id	int	Tag ID
error	int	0 \| 1 - указывает, есть ли ошибка при обработке запроса
message	string	Сообщение об ошибке, пустое, если все в порядке.

Ссылка на пример кода Curl
Ссылка на пример кода Guzzle
Пример ответа:

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

6. Добавить контакты в список контактов:

Пояснение: Добавьте контакты для любого тега. Например, для тега * Сотрудники * ваши коллеги будут идеально подходить.
Конечная точка: https://smsgateway24.com/getdata/savecontact
Метод:: GET, POST

Параметры запроса:

Переменная	Тип	Описание
token	string	[обязательный] Ваш токен получен с помощью метода извлечения токена.
phone	string	[обязательный] phone number
ctag_id	int	[обязательный] Tag ID
fullname	string	[обязательный] Имя клиента

Ответ в формате JSON::

Переменная	Тип	Описание
contact_id	int	Contact Id
error	int	0 \| 1 - указывает, есть ли ошибка при обработке запроса
message	string	Сообщение об ошибке, пустое, если все в порядке.

Ссылка на пример кода Curl
Ссылка на пример кода Guzzle
Пример ответа ... :
{"error":0,"contact_id":15954765,"message":"ok"}

7. Создать рассылку

Пояснение:После создания тега вы можете сделать рассылку по телефонам с тегом.
Конечная точка: https://smsgateway24.com/getdata/savepaket
Метод:: GET, POST

Параметры запроса:

Переменная	Тип	Описание
token	string	[обязательный] Ваш токен получен с помощью метода извлечения токена.
title	string	[обязательный] Название рассылки
device_id	string	[обязательный] ID устройства
body	string	[обязательный] Тело целевого сообщения
tags	string	[обязательный] ID тега. Может быть несколько, разделяя запятыми. Например: 12,13,14
sim	int, default = 0	[обязательный]Номер sim в телефоне: 0 or 1
time_to_send	int, default = 0	[обязательный]Date time when Newsletter should be sent. Do not forget tap start on device. DD.MM.YYYY H:i:s

Ответ в формате JSON::

Переменная	Тип	Описание
contact_id	int	Контактный Id
error	int	0 \| 1 - указывает, есть ли ошибка при обработке запроса
message	string	Сообщение об ошибке, пустое, если все в порядке.
paket_id	int	Package ID

Ссылка на пример кода Curl
Ссылка на пример кода Guzzle
Пример ответа ... :
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f4f49fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

8. Получить список устройств

Пояснение: Вы можете узнать все о ваших устройствах.
Конечная точка: https://smsgateway24.com/getdata/getalldevices
Метод:: GET, POST

Параметры запроса:

Переменная	Тип	Описание
token	string	[обязательный] Ваш токен получен с помощью метода извлечения токена.

Ответ в формате JSON::

Переменная	Тип	Описание
count	int	Количество устройств:
device	json	id - ID устройства title - Имя устройства created - Дата создания устройства createdhumanformat - Дата создания устройства в обычном формате lastseen - Дата последнего просмотра устройства lastseenhumanformat - Дата последнего просмотра устройства serialnumber - Серийный номер устройства siminfo - Информация о SIM-картах в JSON appversion - Версия приложения, установленного на устройстве subscription - На устройстве есть подписка
message	string	Сообщение об ошибке, пустое, если все в порядке.

Ссылка на пример кода Curl
Ссылка на пример кода Guzzle
Пример ответа:

    {
    "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. Получить статус доставки одного SMS

Пояснение: Вы можете узнать состояние доставки каждого SMS, используя этот метод
Конечная точка: https://smsgateway24.com/getdata/getsmsstatus
Метод:: GET, POST

Параметры запроса:

Переменная	Тип	Описание
token	string	[обязательный] Ваш токен получен с помощью метода извлечения токена.
sms_id	int	[обязательный] Sms Id

Ответ в формате JSON::

Переменная	Тип	Описание
sms_id	int	SMS ID
status	int	SMS Status 1 - Ожидание СМС 2 - SMS, принятые по телефону 3 - В очереди для отправки. 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 6 - Отправленное SMS по телефону 7 - SMS доставлено 8 - SMS не было доставлено 9 - SMS не отправлено вовсе - обобщенный сбой. (Читайте что делать с этой ошибкой здесь) Другое, меньше распространенных ошибок: 10 - SMS не отправлено - No Service 11 - SMS не отправлено - Null PDU 12 - SMS не отправлено - Radio Off 100, 101 - SMS не отправлено - NOT ALLOWED. (Разрешения для отправки SMS в приложении не были предоставлены)
status_description	string	Название статуса
error	int	0 \| 1 - произошла ошибка при обработке запроса
message	string	Сообщение об ошибке, пустое, если все в порядке.

Ссылка на пример кода Curl
Ссылка на пример кода Guzzle
Пример ответа:
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f4f49fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

Быстрый доступ

API and integration documentation

Справочник по API

SDKs & tools

Plugins & integrations

1. Получение токена:

2. Send single message using TOKEN:

2.1 Legacy method: send single SMS using login and password

3. Массовая отправка SMS с использованием JSON

4. Получить все SMS (включая входящие SMS):

5. Добавить новый список контактов

6. Добавить контакты в список контактов:

7. Создать рассылку

8. Получить список устройств

9. Получить статус доставки одного SMS

Быстрый доступ

Документация по api

API and integration documentation

Справочник по API

SDKs & tools

Plugins & integrations

1. Получение токена:

2. Send single message using TOKEN:

2.1 Legacy method: send single SMS using login and password

3. Массовая отправка SMS с использованием JSON

4. Получить все SMS (включая входящие SMS):

5. Добавить новый список контактов

6. Добавить контакты в список контактов:

7. Создать рассылку

8. Получить список устройств

9. Получить статус доставки одного SMS