Karta SD

Lista plików i katalogów

Zwraca listę plików i podkatalogów.

POST /api/card/dir/

Parametry żądania:

Pole	Typ	Wymagane	Opis
path	string	Tak	Ścieżka bezwzględna do katalogu.
fromIdx	integer	Nie	Indeks początkowy (domyślnie 0).
toIdx	integer	Nie	Indeks końcowy.

Przykładowe żądanie:

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

Odpowiedź:

Pole	Typ	Opis
fromIdx	integer / null	Indeks pierwszego zwróconego elementu.
toIdx	integer / null	Indeks ostatniego zwróconego elementu.
total	integer	Całkowita liczba elementów w katalogu.
items	array	Tablica obiektów plików/katalogów.

Każdy element w items zawiera:

Pole	Typ	Opis
name	string	Nazwa pliku lub katalogu.
attrib	string	Atrybuty: d (katalog), r (odczyt), w (zapis).
size	integer	Rozmiar pliku w bajtach.
datetime	string	Czas ostatniej modyfikacji (ISO 8601).

Przykładowa odpowiedź:

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

Pobierz informacje o pliku

Zwraca metadane o pliku.

POST /api/card/file/info/

Parametry żądania:

Parametr	Typ	Opis
path	string	Ścieżka bezwzględna do pliku.

Przykładowe żądanie:

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

Odpowiedź:

Pole	Typ	Opis
name	string	Nazwa pliku.
attrib	string	Atrybuty pliku w formacie POSIX (drw).
size	integer	Rozmiar pliku w bajtach.
datetime	string	Data ostatniej modyfikacji (format ISO 8601).

Przykładowa odpowiedź:

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

Odczyt pliku

Zwraca blok danych pliku w kodowaniu base64.

POST /api/card/file/read/

Parametry żądania:

Pole	Typ	Opis
path	string	Ścieżka bezwzględna do pliku.
blockIdx	integer	Numer bloku (zaczynając od 0).

Przykładowe żądanie:

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

Odpowiedź:

Pole	Typ	Opis
blockIdx	integer	Bieżący numer bloku.
blockCount	integer	Całkowita liczba bloków w pliku.
data	string	Dane zakodowane w base64 bieżącego bloku (1024 bajty).

Przykładowa odpowiedź:

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

Zapis pliku

Przesyła dane pliku na kartę SD.

POST /api/card/file/write/

Parametry żądania:

Pole	Typ	Opis
path	string	Ścieżka bezwzględna do pliku (np. /file.bin).
blockIdx	integer	Numer bloku do zapisu (zaczynając od 0).
blockCount	integer	Całkowita liczba bloków do zapisu.
data	string	Dane zakodowane w base64 do zapisu (1024 bajty na blok).

Uwaga: Dane w blokach muszą wynosić dokładnie 1024 bajty, z wyjątkiem ostatniego bloku.

Przykładowe żądanie:

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

Odpowiedź:

Pusty JSON w przypadku sukcesu.

{}

Usuń plik

Usuwa plik z karty SD.

POST /api/card/remove/

Parametry żądania:

Pole	Typ	Opis
path	string	Ścieżka bezwzględna do pliku.

Przykładowe żądanie:

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

Odpowiedź:

Pusty JSON w przypadku sukcesu.

{}

Wysuń kartę SD

Przygotowuje kartę SD do bezpiecznego wyjęcia.

POST /api/cmd/memory/card_eject/

Przykładowe żądanie:

{}

Odpowiedź:

Pusty JSON w przypadku sukcesu.

{}