Základná URL
https://{tenant}.logzi.com/api/worksheet_state/
Každá požiadavka vracia JSON odpoveď. Pri úspešnej odpovedi je result.code == 1, pri chybe result.code == 0. API stavu pracovného listu slúži na správu voľne definovateľných stavov pracovných listov s názvami podľa jazyka. Stav sa priraďuje k pracovnému listu poľom worksheet_state_id (API pracovného listu).
/api/worksheet_state/get
Získanie jedného záznamu stavu pracovného listu podľa identifikátora.
Parametre dotazu
| Parameter | Typ | Povinné | Popis |
|---|---|---|---|
id | int | Identifikátor stavu | |
language_id | int | Identifikátor jazyka pre názov |
Polia odpovede
| Pole | Typ | Popis |
|---|---|---|
id | int | Identifikátor stavu |
name | string | Názov vo vyžiadanom jazyku |
name_key | string | Prekladový kľúč |
sort_order | int | Poradie zoradenia |
remove | int | Príznak odstránenia (0 / 1) |
language_id | int | Identifikátor jazyka |
Príklad požiadavky
GET /api/worksheet_state/get?id=1&language_id=1
X-API-KEY: {vas_api_kluc}
/api/worksheet_state/get_all
Získanie názvov jedného stavu vo všetkých jazykoch (na úpravu).
Parametre dotazu
| Parameter | Typ | Povinné | Popis |
|---|---|---|---|
id | int | Identifikátor stavu (0 alebo prázdne: prázdny zoznam jazykov pre nový záznam) |
Príklad požiadavky
GET /api/worksheet_state/get_all?id=1
X-API-KEY: {vas_api_kluc}
/api/worksheet_state/list
Získanie zoznamu stavov pracovných listov v danom jazyku podľa poradia zoradenia. Odstránené položky nie sú zahrnuté.
Parametre dotazu
| Parameter | Typ | Povinné | Popis |
|---|---|---|---|
language_id | int | Identifikátor jazyka |
Príklad požiadavky
GET /api/worksheet_state/list?language_id=1
X-API-KEY: {vas_api_kluc}
/api/worksheet_state/save
Vytvorenie alebo úprava stavu pracovného listu. Ak je data[id] 0 alebo prázdne, vytvorí sa nový záznam.
POST polia - objekt data
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | int | Identifikátor stavu (0 alebo prázdne = nový) | |
name_key | string | Prekladový kľúč, najviac 50 znakov. Pre nový záznam jedinečný kľúč, napr. s_db_wsstate_<32-znakový md5> | |
data[<language_id>] | string | Názov pre každý jazyk (aspoň 2 znaky) | |
sort_order | int | Poradie zoradenia (predvolené: 0) |
Príklad požiadavky
POST /api/worksheet_state/save
X-API-KEY: {vas_api_kluc}
Content-Type: application/json
{ "data": { "id": 0, "name_key": "s_db_wsstate_0f3c9a1b7d5e4c2a8b6d1e9f3a7c5b2d", "sort_order": 10, "data": { "1": "Folyamatban", "2": "In progress" } } }
/api/worksheet_state/delete
Odstránenie stavu pracovného listu (logické odstránenie, príznak remove sa nastaví na 1).
POST polia - objekt data
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | int | Identifikátor stavu, ktorý sa má odstrániť |
Príklad požiadavky
POST /api/worksheet_state/delete
X-API-KEY: {vas_api_kluc}
Content-Type: application/json
{ "data": { "id": 1 } }
Zaregistruj sa teraz,
zaplať neskôr!