SD-карта

Список файлів та каталогів

Повертає список файлів та підкаталогів.

POST /api/card/dir/

Параметри запиту:

Поле	Тип	Обов’язково	Опис
path	string	Так	Абсолютний шлях до каталогу.
fromIdx	integer	Ні	Початковий індекс (за замовчуванням 0).
toIdx	integer	Ні	Кінцевий індекс.

Приклад запиту:

{
    "path": "/logs",
    "fromIdx": 0
}

Відповідь:

Поле	Тип	Опис
fromIdx	integer / null	Індекс першого повернутого елемента.
toIdx	integer / null	Індекс останнього повернутого елемента.
total	integer	Загальна кількість елементів у каталозі.
items	array	Масив об’єктів файлів/каталогів.

Кожен елемент у items містить:

Поле	Тип	Опис
name	string	Назва файлу або каталогу.
attrib	string	Атрибути: d (каталог), r (читання), w (запис).
size	integer	Розмір файлу в байтах.
datetime	string	Час останньої модифікації (ISO 8601).

Приклад відповіді:

{
    "fromIdx": 0,
    "toIdx": 0,
    "total": 1,
    "items": [
        {
            "name": "ATM.LOG",
            "attrib": "-rw",
            "size": 5768906,
            "datetime": "2025-04-16T16:07:38"
        }
    ]
}

Отримати інформацію про файл

Повертає метадані про файл.

POST /api/card/file/info/

Параметри запиту:

Параметр	Тип	Опис
path	string	Абсолютний шлях до файлу.

Приклад запиту:

{
    "path": "/sgs.bin"
}

Відповідь:

Поле	Тип	Опис
name	string	Назва файлу.
attrib	string	Атрибути файлу у форматі POSIX (drw).
size	integer	Розмір файлу в байтах.
datetime	string	Дата останньої модифікації (формат ISO 8601).

Приклад відповіді:

{
    "name": "SGS.BIN",
    "attrib": "-rw",
    "size": 860,
    "datetime": "2025-04-16T15:12:52"
}

Читати файл

Повертає блок даних файлу в кодуванні base64.

POST /api/card/file/read/

Параметри запиту:

Поле	Тип	Опис
path	string	Абсолютний шлях до файлу.
blockIdx	integer	Номер блоку (починаючи з 0).

Приклад запиту:

{
    "path": "/sgs.bin",
    "blockIdx": 0
}

Відповідь:

Поле	Тип	Опис
blockIdx	integer	Номер поточного блоку.
blockCount	integer	Загальна кількість блоків у файлі.
data	string	Дані поточного блоку в кодуванні Base64 (1024 байти).

Приклад відповіді:

{
    "blockIdx": 0,
    "blockCount": 2,
    "data": "63sM/2R3ki8uAC4AAQBMA9AHCAQBAAEBAAEAAAEBAW8FAQELAw8DPFAAWAJuZf//9gGXiHgAyADoAxQABQAAAFoAAACAJQAAgIwo2MCoAHP///8AwKgAAQgICAgICAQE2IA5aQ5tZ2FwAAAAAAAAAAAAZ2FwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKAAH/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB4TADs5AAACbnRwLnRpbWUuaW4udWEAAAAAAAAAAG50cDIuc3RyYXR1bTEucnUAAAAAAAABGAEMAwoHAgoKBwIAABMAKjExMSMAAAAAAAAAAAAAAMCoAHD2AegDFAAAAAAAAf8AAAAAAAAAAAAAAADAqABx9gHoAxQAAAAAAAH/AAAAAAAAAAAAAAAAwKgAcvYB6AMUAAAAAAAB/wAAAAAAAAAAAAAAAMCoAHP2AegDFAAAAAAAAf8AAAAAAAAAAAAAAADAqAB09gE="
}

Записати файл

Завантажує дані файлу на SD-карту.

POST /api/card/file/write/

Параметри запиту:

Поле	Тип	Опис
path	string	Абсолютний шлях до файлу (напр., /file.bin).
blockIdx	integer	Номер блоку для запису (починаючи з 0).
blockCount	integer	Загальна кількість блоків для запису.
data	string	Дані для запису в кодуванні Base64 (1024 байти на блок).

Примітка: Дані у блоках повинні бути строго 1024 байти, за винятком останнього блоку.

Приклад запиту:

{
    "path": "/file.bin",
    "blockIdx": 0,
    "blockCount": 2,
    "data": "63sM/2R3ki8uAC4AAQBMA9AHCAQBAAEBAAEAAAEBAW8FAQELAw8DPFAAWAJuZf//9gGXiHgAyADoAxQABQAAAFoAAACAJQAAgIwo2MCoAHP///8AwKgAAQgICAgICAQE2IA5aQ5tZ2FwAAAAAAAAAAAAZ2FwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKAAH/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB4TADs5AAACbnRwLnRpbWUuaW4udWEAAAAAAAAAAG50cDIuc3RyYXR1bTEucnUAAAAAAAABGAEMAwoHAgoKBwIAABMAKjExMSMAAAAAAAAAAAAAAMCoAHD2AegDFAAAAAAAAf8AAAAAAAAAAAAAAADAqABx9gHoAxQAAAAAAAH/AAAAAAAAAAAAAAAAwKgAcvYB6AMUAAAAAAAB/wAAAAAAAAAAAAAAAMCoAHP2AegDFAAAAAAAAf8AAAAAAAAAAAAAAADAqAB09gE="
}

Відповідь:

Порожній JSON у разі успіху.

{}

Видалити файл

Видаляє файл з SD-карти.

POST /api/card/remove/

Параметри запиту:

Поле	Тип	Опис
path	string	Абсолютний шлях до файлу.

Приклад запиту:

{
    "path": "/1.pdf"
}

Відповідь:

Порожній JSON у разі успіху.

{}

Безпечне вилучення SD-карти

Підготовує SD-карту для безпечного вилучення.

POST /api/cmd/memory/card_eject/

Приклад запиту:

{}

Відповідь:

Порожній JSON у разі успіху.

{}