SMS API Документация — SIMCARD.UZ | REST API для SMS рассылки Узбекистан

Аутентификация

Все запросы требуют API-ключ. Получите его в личном кабинете в разделе «API ключи».

🔑

Заголовок запроса

Authorization: Bearer YOUR_API_KEY

POST Отправить SMS

Отправка одного SMS-сообщения на указанный номер телефона.

https://simcard.uz/gateway/services/send.php

# Отправить SMS
curl -X POST "https://simcard.uz/gateway/services/send.php" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "phone=+998901234567" \
  -d "message=Ваш код: 4521"

$response = file_get_contents('https://simcard.uz/gateway/services/send.php', false,
  stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer YOUR_API_KEY\r\nContent-Type: application/x-www-form-urlencoded",
    'content' => http_build_query([
      'phone'   => '+998901234567',
      'message' => 'Ваш код: 4521',
    ])
  ]])
);
$result = json_decode($response, true);

import requests

r = requests.post(
    "https://simcard.uz/gateway/services/send.php",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    data={"phone": "+998901234567", "message": "Ваш код: 4521"}
)
print(r.json())

const res = await fetch("https://simcard.uz/gateway/services/send.php", {
  method: "POST",
  headers: { "Authorization": "Bearer YOUR_API_KEY" },
  body: new URLSearchParams({
    phone: "+998901234567", message: "Ваш код: 4521"
  })
});
const data = await res.json();

Параметр	Тип	Обязательный	Описание
phone	string	Обяз.	Номер телефона в формате +998XXXXXXXXX
message	string	Обяз.	Текст SMS (макс. 160 символов)
device_id	integer	Необяз.	ID устройства. По умолчанию — первое активное
sim_slot	integer	Необяз.	Слот SIM-карты: 1 или 2

Ответ

{ "success": true, "id": 48291, "status": "queued" }

POST Массовая рассылка

Отправка SMS сразу на несколько номеров за один запрос.

https://simcard.uz/gateway/services/send.php

curl -X POST "https://simcard.uz/gateway/services/send.php" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "phones[]=+998901234567" \
  -d "phones[]=+998931234567" \
  -d "phones[]=+998711234567" \
  -d "message=Акция! Скидка 20% до конца месяца."

Параметр	Тип	Обязательный	Описание
phones[]	array	Обяз.	Массив номеров телефонов
message	string	Обяз.	Текст сообщения
device_id	integer	Необяз.	ID устройства для отправки

GET Статус сообщения

Проверка статуса отправленного сообщения по его ID.

https://simcard.uz/gateway/services/status.php?id={message_id}

curl -X GET "https://simcard.uz/gateway/services/status.php?id=48291" \
  -H "Authorization: Bearer YOUR_API_KEY"

Статусы

Статус	Описание
queued	В очереди на отправку
sent	Отправлено с устройства
delivered	Доставлено получателю
failed	Ошибка отправки

GET Список устройств

Получить список подключённых Android-устройств и их статус.

https://simcard.uz/gateway/services/devices.php

curl -X GET "https://simcard.uz/gateway/services/devices.php" \
  -H "Authorization: Bearer YOUR_API_KEY"

[ { "id": 1, "name": "Samsung Galaxy A52", "online": true, "sim_slots": 2, "battery": 87 } ]

Webhook

Настройте Webhook URL в личном кабинете — и мы будем отправлять POST-запрос на ваш сервер при каждом событии (доставка, входящее SMS).

Пример входящего запроса

{ "event": "sms_received", "from": "+998901234567", "message": "Привет!", "device_id": 1, "received_at": "2025-04-17 14:30:00" }

Обработка на PHP

$data = json_decode(file_get_contents('php://input'), true);

if ($data['event'] === 'sms_received') {
    $from    = $data['from'];
    $message = $data['message'];
    // обработка входящего SMS
}

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