Удалить устройство

Удаляет устройство из вашего аккаунта GoSMS.

Метод: DELETE
Эндпоинт: /api/ext/v1/devices/{id}
Требуемое разрешение: devices:delete

WARNING

После удаления устройство потеряет привязку к аккаунту. Мобильное приложение на этом устройстве придётся подключить заново. Все SMS в очереди для этого устройства останутся в базе, но не будут отправлены пока оно не подключится снова.

Параметры пути

Параметр	Тип	Описание
id	string (UUID)	ID устройства

Ответ — 204 No Content

При успешном удалении сервер возвращает статус 204 без тела ответа.

Ошибки

Статус	Причина
400 Bad Request	Неверный формат UUID
404 Not Found	Устройство не найдено или принадлежит другому пользователю

Примеры

curl

curl -X DELETE \
  "https://api.gosms.ru/api/ext/v1/devices/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer ВАШ_КЛЮЧ"

Python

import requests

def delete_device(device_id: str) -> bool:
    response = requests.delete(
        f"https://api.gosms.ru/api/ext/v1/devices/{device_id}",
        headers={"Authorization": "Bearer ВАШ_КЛЮЧ"},
    )
    if response.status_code == 204:
        return True
    if response.status_code == 404:
        return False
    response.raise_for_status()
    return False

# Удалить конкретное устройство
ok = delete_device("550e8400-e29b-41d4-a716-446655440000")
print("Устройство удалено" if ok else "Устройство не найдено")

JavaScript

async function deleteDevice(deviceId) {
  const response = await fetch(
    `https://api.gosms.ru/api/ext/v1/devices/${deviceId}`,
    {
      method: 'DELETE',
      headers: { 'Authorization': 'Bearer ВАШ_КЛЮЧ' },
    }
  );

  if (response.status === 204) return true;
  if (response.status === 404) return false;

  const err = await response.json();
  throw new Error(err.error.message);
}

const removed = await deleteDevice('550e8400-e29b-41d4-a716-446655440000');
console.log(removed ? 'Удалено' : 'Не найдено');

Удалить все офлайн-устройства

import requests

headers = {"Authorization": "Bearer ВАШ_КЛЮЧ"}

# Получаем список
devices = requests.get(
    "https://api.gosms.ru/api/ext/v1/devices",
    headers=headers
).json()

# Удаляем офлайн-устройства
offline = [d for d in devices if not d["is_online"]]
print(f"Найдено {len(offline)} офлайн-устройств")

for device in offline:
    name = device["name_custom"] or device["name"]
    resp = requests.delete(
        f"https://api.gosms.ru/api/ext/v1/devices/{device['id']}",
        headers=headers,
    )
    if resp.status_code == 204:
        print(f"  ✅ Удалено: {name}")
    else:
        print(f"  ❌ Ошибка: {name}")